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

AX Code v7.7.6 發行說明

狀態：現行 範圍：公開、目前的發行說明（CLI／TUI） 上次審閱：2026-08-21 負責人：AX Code 發行工程

2026 年 8 月 20 日發行 · 完整變更紀錄

這些說明涵蓋 v7.2.0 到 v7.7.6 這條線的 CLI 與終端機 TUI 表面。桌面應用程式的變更另行追蹤，見 CHANGELOG.md。

v7.7 這個系列強化了 CLI 與 TUI，以支援長時間、無人值守的工作：串流正確性、當機韌性、供應商可靠性，以及一次大規模的 CLI 易用性整理，同時還有依專案分片的儲存，以及大幅重做的串流效能。

重點

• 串流效能重做：TUI 現在會在 RPC 邊界之前合併增量，把串流文字畫成純文字（在收尾時才掛上富文本繪製器一次），讓串流列保持掛載並使用批次事件視窗，而且繪製間隔會隨文件長度調整。長工作階段仍然保持回應。
• 當機與終端機韌性：遇到未處理的拒絕時，TUI 會讓工作階段繼續存活；後端死亡時會顯示出來，而不是靜靜掛住；終端機在工作階段中途死亡時會停止當機迴圈，並強化終端機輸入處理。
• CLI 可靠性整理：指令失敗現在會產生可讀的錯誤與非零結束代碼（#398 到 #400）；ax-code run 會在建立工作階段之前驗證模型（#405）；刪除或修剪工作階段需要確認，或使用 --force（#403）；附加元件缺少時，doctor 的原生附加元件旗標會被標註（#401），而且不再把健康狀態誤報為通過。
• 依專案分片的儲存：工作階段、訊息、重播事件日誌、待辦、目標、工作佇列、排程工作與工作流程資料表，可以路由到依專案劃分的 SQLite 分片（第 2 階段，由 AX_CODE_SHARD_SESSIONS 把關），並強化並行寫入，以及在啟動初始化時讓 SQLITE_BUSY 仍能存活。
• 供應商可靠性：供應商退回會在對話紀錄中顯示通知（#394）；串流文字增量會與快照核對；輸出迴圈偵測會帶著指引復原，而不是盲目重試；作用中的工作階段在供應商切換之後仍然存活。

新功能

• feat(tui)：狀態、通知、進度與倒回控制；開始畫面與提示頁尾上的模式標籤；由工作佇列支援的、執行中子代理程式軌道；從按鍵綁定結構描述產生的說明對話框；預設啟用 kitty 鍵盤協定；AX Engine 下載的可見性（進度標籤、完成提示、送出防護）；每個回合之後的閒置回顧橫幅。
• feat(cli)：用於背景工作管理的 ax-code task list|show|cancel|retry。
• feat(agent)：waitfor 工具、生命週期鉤子事件（ADR-057）、帶有 WebFetch 路徑的 Scout 子代理程式，以及 /verified-fix 工作流程。
• feat(autonomy)：選擇加入的語意預先核准守護，使用專用的守護模型，以及失敗即關閉的測試；自主模式已強化，以防止自我提升權限，以及危險的 git 設定寫入。
• feat(provider)：供應商管理員介面，可暫時停用與啟用；Hugging Face 與 UnoRouter 加入預設的登入供應商；目錄的系列篩選；AX Engine 的受管理與附加連線模式，帶有六個模型的 AXQuant 目錄，以及 TUI 的下載提議。
• feat(code-intelligence)：符號相關性訊號、以符號為錨點的跨工作階段筆記、DRE 自動筆記，以及暖機提示。
• feat(session)：類似 /loop 的排程強化，以及長時間工作執行的改進。

改進

• refactor(tui)：整合由 AX 擁有的繪製器套件；恢復 OpenTUI 套件契約並加強檢查；opentui-spinner 的建置可重現，並含型別檢查。
• perf(tui)：頁尾的上下文量表現在對照壓縮預算來測量；過時的工具頁尾狀態已簡化。
• refactor(ax-engine)：鎖定各模型專用的上下文原則；本機陣容只保留 6 位元。
• 設定的持久化現在可以在隔離與設定中保留 JSONC 註解。
• ax-code 會設定自己的處理程序標題，doctor 的執行個體檢查會忽略 TUI 後端。

修正

• 工作階段：串流文字增量已與快照核對；工具呼叫的最後防線會重設連續次數，並在到達上限時觸發（#390）；壓縮歷史會修剪，以放進較小的模型視窗；串流中的模型輸出迴圈會被停下，而不必退出本機供應商；排程工作已強化，以對付被字串化的參數。
• 供應商：Kimi 的無介面執行已穩定；已驗證 Kimi 與 DeepSeek 的能力註冊；已連線 CLI 的模型選擇已強化；MiniMax Token Plan 的輔助模型偏好、重新命名，以及過期 SKU 的移除；Alibaba Token Plan 的允許清單篩選；Groq 與 Zhipu 目錄已依官方文件更新；執行環境 SDK 的安裝已釘選。
• 驗證：登入可以撐過 canary 失敗，並防護非 TTY 流程（#392、#393）；providers logout 可以移除無法解密的憑證。
• TUI：內部 TUI 程式碼審查帶來十項正確性修正；ctrl+j 會插入換行，而不是送出；探索期間會保留已選的模型；已停止失效的模型選擇；工作階段截斷、連線狀態與提示風暴已受到控制。
• 平台：Windows 自我升級，並在更新後驗證；PTY、SQLite 與 CLI 設定已強化；獨立執行環境的封裝已強化。
• 測試：測試套件在執行之前，會去掉繼承而來的 AX_CODE_* 主機工作階段旗標。

淘汰與移除

• feat(provider)!：gemini-cli 與 antigravity-cli 供應商已停用。
• feat(ax-engine)!：AXQuant 目錄改為固定的六個模型陣容。

安裝與驗證

已簽章的封存附在這次發行，適用於 darwin-arm64、windows-x64 與 windows-arm64，另加 install.ps1。請對照已公布的 ax-minisign.pub，使用 發行驗證指南 中的步驟，驗證任何資產。