语言和翻译

ZeroClaw 的界面字符串（CLI 消息、命令帮助以及 zerocode TUI）可以使用英语以外的语言显示。英语始终内置，其他语言按需下载。

设置语言

ZeroClaw 会从配置文件中读取顶层的 locale 键。请将其设置为区域代码，例如 ja、fr 或 zh-CN。如果未设置 locale，ZeroClaw 将使用操作系统的语言，并在没有可用翻译时回退到英语。

获取你的语言文件

英语已内置于二进制文件中。对于其他任何语言，您只需获取一次翻译文件：

zeroclaw locales fetch ja

这将从 ZeroClaw 项目下载日语翻译文件，并将其安装到 ~/.zeroclaw/data/ftl/ja/ 目录下，ZeroClaw 会在启动时从该位置查找这些文件。安装完成后请重启 ZeroClaw（以及 zerocode）以使其生效。

以相同方式获取任何语言区域：

zeroclaw locales fetch fr        # 法语
zeroclaw locales fetch zh-CN     # 简体中文

仅获取部分语言

默认情况下，fetch 会下载该区域设置的所有目录。如需仅下载部分目录，请传入 --catalog 并附带以逗号分隔的列表：

zeroclaw locales fetch ja --catalog cli            # 仅 CLI 字符串
zeroclaw locales fetch ja --catalog cli,zerocode   # CLI + TUI

如果某个目录尚未翻译为你的语言，fetch 会跳过它并提示你：已存在的目录仍会被安装。

文件存放位置

如果你使用自定义配置目录（--config-dir 或 ZEROCLAW_CONFIG_DIR）运行 ZeroClaw，文件将改为安装在该目录的 data/ftl/ 下。

故障排除

• 抓取后仍显示英文。 请确认配置中的 locale 与你抓取的语言区域一致，然后重启进程。ZeroClaw 会在启动时加载语言文件。
• fetch 报告某个目录已被跳过。 该目录尚未针对你的语言区域进行翻译。可用的目录仍会安装；未翻译的字符串将回退为英文。
• 某个特定字符串显示为英文，而其余内容已翻译。 该字符串尚无对应译文，会按设计回退至英文。