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

TUI 語言與初次設定

狀態：現行

範圍：現行狀態

上次審閱：2026-09-14

負責人：ax-code 執行環境

AX Code 的 TUI 支援英文（en）、繁體中文（zh-TW）、簡體中文（zh-CN）、日文（ja）、韓文（ko）、西班牙文（es）、巴西葡萄牙文（pt-BR）、法文（fr）、德文（de）、俄文（ru）、印尼文（id）、土耳其文（tr）、越南文（vi）與義大利文（it）。已在地化的表面包含設定、導覽、常用指令、鍵盤說明、提示控制、供應商選擇、權限決定、工作階段對話框、執行環境狀態，以及 Council 與 Arena 的呈現。

執行 /language（別名 /lang），可以分別選擇介面語言與對話語言。語言選擇器會以該語言自己的文字顯示每種語言。介面變更會立即套用。對話變更套用到之後的提示，以及由模型支援的斜線指令，包含 Council 與 Arena 請求。Auto 保留既有的對話行為。使用者的明確指示與專案規則優先於這項偏好。殼層指令會原樣送出。

原始的使用者訊息會被保留。對話偏好會分開帶上；AX Code 不會在執行之前翻譯工作。程式碼註解、提交與文件遵循專案規則；當選了明確的對話偏好時，預設會要求使用英文。技術識別名稱、路徑、指令、原始工具輸出與引用的證據保持不變。

初次設定

全新的互動式安裝，若沒有已設定的供應商或工作階段，會在初始化之後提供快速設定：

選擇介面語言。十四種語言一起提供；在較矮的終端機中，用方向鍵捲動清單。
透過既有的連線對話框連接供應商並選擇模型。依情況選擇已安裝的程式開發 CLI、雲端 API、本機執行環境、私有 GPU 端點，或 AX Trust 閘道。
開始一項工作。唯讀審查是有用的第一項工作；核准之前請先查看指令與其範圍。

你可以略過設定，再用 /setup 重新開啟。取消供應商設定會回到檢查清單。已經設定好的使用者、續接的工作階段，以及明確的 --prompt 啟動，都不會被打斷。載入與連線錯誤，與尚未設定的安裝是分開的。選擇模型會建立設定就緒；第一次請求會檢查即時連線。設定不會自動授予權限、安裝執行環境或下載模型。

設定

選擇性的預設放在 tui.json，不是執行環境舊的 language 設定：

{
  "interface_language": "zh-TW",
  "conversation_language": "ja"
}

介面的值：en、zh-TW、zh-CN、ja、ko、es、pt-BR、fr、de、ru、id、tr、vi、it。對話也接受 auto。預設是 en 與 auto。透過 /language 所做的選擇會存在本機 TUI 狀態，並覆寫這些檔案預設。再用 /language 可以重新更改。語言選擇不會改變憑證或伺服器原則。

Council 與 Arena 的在地化只改變呈現標籤。成員證據、支持次數、排序順序、驗證狀態與原始錯誤都保持原樣。供應商提供的授權文字、專門的工具輸出，以及專門的診斷表面，仍可能以原本的語言出現。原始工具輸出、技術識別名稱、使用者內容與文件都不會被翻譯。

對貢獻者來說，pnpm --dir packages/ax-code run check:tui-locales 會驗證完整目錄、佔位符、NFC 正規化、已審閱的共用拼寫、核心選單的原始碼防護，以及在語言即時變更下的原生對話框繪製。請為每種語言維持分開、且已審閱的目錄；不要只靠字元轉換得出繁體中文。

越南文目錄使用 NFC。顯示截斷會保留字素叢集，包含分解後的輸入。原生繪製檢查涵蓋 36 欄與 80 欄的終端機。若終端機設定成把寬度不明確的字元畫成兩個儲存格，需要另外做該終端機專用的資格認定；目前的繪製器沒有公開這種寬字元的測試模式。