本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 7.24.4 · SDK 2.6.7。 英文原文

AX Code 文件

狀態：有效 範圍：公開、目前狀態 上次審閱：2026-10-09 負責人：AX Code 維護者

AX Code 是面向可檢閱、可還原工作的程式開發 agent 執行環境：每個工作階段都記錄成 帶有檔案快照的結構化事件紀錄，候選實作可以用你儲存庫自己的 檢查來驗證，而且不會自動合併。為什麼選擇 AX Code 說明它最佳化的是什麼、適合 誰，以及它刻意不宣稱什麼。

根目錄 README 是安裝並啟動 AX Code 的最短路徑。當你需要 設定工作流程、理解執行環境邊界，或把 AX Code 與另一個系統整合時，請使用這個中心。

內部流程紀錄（PRD、ADR、規格、路線圖、實作計畫、競爭檢閱與稽核 工作檔）位於 .internal/，不在這棵公開樹中——見下方「文件邊界」。這裡連結的 才是公開頁面。

公開網站：ax-code.app 文件。 既有安裝請從升級與復原開始。 原始碼存取與公開下載是分開的；見原始碼存取。

依工作選擇

若要透過外部 MCP 用戶端選擇加入共用的終端機導覽，見 透過 MCP 分享即時 TUI。

實驗性的瀏覽器橋接（讀取頁面，可選擇點擊與填寫）見 WebMCP 瀏覽器橋接。

透過 AX Trust 快取、針對選定檔案的獨立問題，見 固定上下文問題。

開始使用

• Standard 與 Business — 開源 Standard、免費商業使用、規劃中的專有 Business，以及公開存取狀態。

• 為什麼選擇 AX Code — AX Code 最佳化的是什麼、預定對象、它有何不同，以及它 不宣稱什麼。

• 從這裡開始 — 產品心智模型，以及依使用情境的最短路徑。

• 安裝與執行環境通道 — 受支援平台、套件、更新，以及 貢獻者啟動器。

執行環境指南

• Wiki 證據視覺化 — 開啟已記錄 Wiki 頁面／來源關係的本機圖，或匯出離線 HTML。包含來自 AX Code 自身 wiki 的放射、力導向與頁面聚焦截圖。
• 對話回顧 — 用 /recap 追上近期工作，並設定閒置橫幅。
• 音訊通知 — 執行需要你注意時的系統音效與選擇加入的語音提示。
• 執行證據 — 圖、比較、重放、風險、回復、分支、追蹤，以及 稽核匯出。
• 已驗證的多模型變更 — 從頭到尾的 council 與 arena 工作流程。
• 沙盒模式 — 隔離模式、受保護路徑、網路控制與優先順序。
• 雲端維運模式 — 計畫／核准／套用工作流程、核准權杖，以及 cloudops agent 態勢。
• 自主模式 — 無人值守執行、核准、無頭使用與防護。
• 無頭 CLI — 供指令稿、CI 與 agent 呼叫者使用的單次 ax-code run 指令。
• TUI 語言與設定 — 介面與對話語言、第一次設定。
• TUI 動畫 — 開場與結束配對、終端機能力與繪製退回。
• 迴圈模式與排程工作 — 重複提示、可持久排程與長時間執行限制。
• 長時間執行的作業 — 受監督服務範例、復原語意，以及 操作檢查。
• 執行模式 — agent、混合、council 與 arena 行為。
• 多模型路由的最佳做法 — 拆開高階推理與較低成本的支援 工作，而不悄悄削弱對正確性敏感的工作。
• 模型選擇與復原 — 精確的模型選擇、明確的備援設定與診斷。
• 自動路由 — 專家路由與選用的複雜度路由。
• 模型努力程度 — 思考等級與依供應商而異的行為。
• 效能 — 程式開發工具設定檔與本機請求計時診斷。
• 記憶體用量 — 記憶體設定檔、快取保留與背景輸出限制。
• 本機證據快取 — 選用的 SQLite 與 RocksDB 證據重用、資格認定與回復。
• 生命週期 Hooks — hook 事件與隨附的原則套件。
• 執行報告 — 工作區用量、活動、模型／工具細分，以及逐工作階段報告。

供應商

• 支援的供應商與模型 — 供應商 ID、憑證與模型探索。
• 免費方案 API 快速開始 — 相容的零成本路徑、限制與安全評估。
• 自訂與閘道供應商 — OpenAI 與 Anthropic 相容端點。
• MTPLX 與 oMLX 設定 — 原始碼檢出的本機預設集、探索、工具與驗證。
• Tiel 同儕摘要（2026 年 9 月 20 日） — 目前 Tiel／Cyber-Tiel 對 MTPLX 的原生 API 數字；完成預設 194.88，峰值解碼 249.01。
• AX Code／OpenCode 用戶端再測 — 六種用戶端／執行環境組合、作用中的 MTP、首次／重複計時，以及程式碼檢查。
• 本機推論測量 — 有日期的 AX Code／OpenCode 與執行環境測試，含計時與可比性限制。
• AX Engine 模型選擇 — 本機模型排名與記憶體指引。

整合

• MCP 整合 — 信任、權限、資源與伺服器安全性。
• ACP — 給 IDE 主機的 Agent Client Protocol 順利路徑。
• AX Wiki — 以原始碼為依據的儲存庫知識與 CI 工作流程。
• VS Code 整合 — 編輯器指令、設定與工作流程。從市集清單安裝。

SDK 與服務邊界

• @defai-digital/ax-code-sdk — 第一方 TypeScript 與 JavaScript 嵌入。
• 原生 SDK 傳輸 — 以 gRPC 為形狀的桌面／原生邊界與退回行為。
• HTTP 與 OpenAPI 相容性 — 伺服器模式，以及為其他語言產生的用戶端。
• OpenAPI 快照 — 權威的 HTTP 路由與結構描述契約。

架構與可靠性

• 語意層 — 圖與 LSP 來源、稽核與重放邊界。
• 本機引擎架構 — AX Code 為什麼使用 AX Engine 附屬程式。
• 執行環境穩定性 — 取消、崩潰、串流、逾時與 TUI 可靠性契約。

參考

• 設定 JSON 結構描述 — 產生的設定輸入契約。

• TypeScript 原生支援 — 原始碼編譯器、語言服務、診斷與相容性。

• 技能與外掛目錄 — 隨附技能、專案技能、外掛與評估。

• 隔離原則套件 — 機器可讀的原則範例。

• 發行驗證 — 標準的 minisign 公開金鑰與驗證指令。

• Windows 執行環境完整性 — 簽章、已安裝檔案驗證與防毒證據。

• 安全性原則 — 威脅模型、憑證儲存與受支援版本。

文件邊界

docs/ 包含已在已發行執行環境中存在之行為的公開指引。規劃材料、發行目標、 實作原則與暫時分析不屬於這裡：

每個公開 Markdown 頁面都應在靠近頂端處宣告狀態、範圍、上次審閱日期與負責人。偏好連結到 產生的契約或實作來源，而不是複製路由清單與其他容易漂移的快照。

維護檢查清單

在發行或實質文件變更之前：

1. 對照實作驗證指令、預設值、旗標、供應商 ID 與執行環境標籤。
2. 更新範圍最窄的權威指南，而不是在數個入口頁面重複相同行為。
3. 執行 pnpm run test:scripts，以抓出損壞的本機連結、孤立頁面與缺少的頁面中繼資料。
4. 更新核准的匯出資訊清單並執行 node script/export-public-docs.mjs --website /path/to/ax-code.app， 然後執行網站檢查、建置與 Workers 冒煙檢查。網站建置使用已提交的快照，不 需要原始碼存取。新的公開頁面與資產必須在資訊清單中明確核准。
5. 把提案、專案開發筆記、發行目標與歷史決策紀錄留在 .internal/， 不要放進公開導覽。