Hermes Agent v0.16 简体中文语言包激活与切换指南

要让 Hermes Agent v0.16 的桌面端和 CLI 界面完整显示简体中文，并非修改单一配置就能搞定——语言包加载依赖于环境变量、配置文件和模板资源三者协同，任何一环缺失都会导致回退至英文界面，或出现部分文字乱码。

确认系统级中文 locale 已启用

这一步是底层前提，跳过的话，后续所有配置都可能失效。Hermes v0.16 依赖系统 locale 判断是否加载 zh_CN 资源目录，若不设置，系统根本找不到中文翻译文件。

在终端运行 locale | grep -E "LANG|LC_ALL"，查看输出是否包含 LANG=zh_CN.UTF-8。若没有，执行 export LANG=zh_CN.UTF-8 && export LC_ALL=zh_CN.UTF-8。然后将这两行追加到 ~/.zshrc（macOS）或 ~/.bashrc（Linux），再运行 source ~/.zshrc 使其永久生效。这一步很关键，别偷懒。

桌面端一键启用中文（推荐新手）

桌面版自带交互式向导，比手动修改 YAML 更可靠，尤其适合首次安装的用户。

启动 Hermes Desktop 后，首次打开会自动弹出 setup 向导；若跳过了，可以点击左下角齿轮图标 → Settings → Run Setup Wizard。在 “Select your preferred language” 页面，用方向键选中“中文（简体）”，按回车确认。向导会自动生成 config.yaml 并写入 language: zh-CN 和 ui.locale: zh-CN。完成后重启桌面客户端，界面、提示语、/help 输出都会变成中文。

CLI 端手动配置中文（适配已有环境）

如果你已经在命令行使用 Hermes，并且不想再跑一遍 setup，直接编辑配置文件即可。

第一步：打开 ~/.hermes/config.yaml，定位到 core: 或文件顶部空白处，添加 language: zh-CN。

第二步：在 ui: 区块下补充 locale: zh-CN 和 prompt_style: chinese；若原来没有 ui: 区块，就新建一行 ui:，再换行缩进写 locale: zh-CN。

第三步：确认 ~/.hermes/locales/zh_CN/static_text.json 存在。若缺失，从 GitHub releases 下载对应版本并放入该路径。

第四步：执行 hermes stop && hermes start 重启服务，避免缓存干扰。

运行时临时切换语言（调试用）

方法一：在任何对话中输入 /set language zh_CN，Agent 会立即响应“语言已设为简体中文(zh_CN)”，本次会话后续输出强制为中文。

方法二：启动时指定环境变量，不修改配置文件：LANG=zh_CN.UTF-8 hermes start。

需要注意：/set 命令只影响当前会话，重启后失效；环境变量方式每次都需要手动加前缀。

验证中文是否完整生效

① 在 CLI 中输入 /help，查看命令说明是否全部为中文。

② 输入 /model info，检查模型描述字段是否包含中文。

③ 在桌面端点击右上角头像 → About，确认版本信息页的文字是中文。

④ 执行 hermes doctor --lang zh_CN，若返回“✅ All Chinese localization paths resolved”，说明语言包加载成功。