本页译自英文文档。命令、标识符和示例保持原样。运行时 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 保留现有的对话行为。显式的用户指示和项目规则优先于该偏好。Shell 命令原样发送。

原始用户消息予以保留。对话偏好单独携带；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 列终端。配置为把歧义宽度字符渲染成两个单元格的终端需要单独的终端特定资格确认；当前渲染器不提供歧义宽字符测试模式。