如何将HermesAgent配置文件汉化？通过编辑Yaml文件打造纯中文操作界面？

本文共计1448个文字，预计阅读时间需要6分钟。

如果已部署Hermes Agent，但CLI界面、提示信息和配置反馈未使用中文，可能是由于系统未启用本地化支持或核心YAML配置中缺少足够语言覆盖的文本段。以下为实现全中文交互界面的具体操作步骤：

一、启用全局 locale 与中文环境变量

该步骤确保 Hermes 运行时底层 Python 环境识别中文区域设置，避免因 locale 缺失导致 YAML 中文字段被忽略或解析异常。Hermes 自 v0.8.3 起支持基于 LANG 和 LC_ALL 的语言自动匹配机制。

1、打开终端，执行命令确认当前 locale 设置：locale | grep -E "LANG|LC_ALL"

2、若输出中 LANG 不为 zh_CN.UTF-8 或为空，执行以下命令临时生效：export LANG=zh_CN.UTF-8 && export LC_ALL=zh_CN.UTF-8

3、将上述两行追加至 ~/.bashrc（Linux/macOS）或 ~/.zshrc（Zsh 用户），使配置永久生效。

4、执行 source ~/.bashrc 重载配置，并再次运行 locale 验证输出是否包含 zh_CN.UTF-8。

二、修改 config.yaml 启用中文界面渲染

该步骤通过在主配置文件中显式声明 language 字段，强制 Hermes CLI、help 提示、错误消息及技能响应模板使用简体中文。此字段自 2026 年 4 月发布的 v0.9.0 版本起正式支持，无需额外插件。

1、使用文本编辑器打开 ~/.hermes/config.yaml 文件。

2、在文件顶部或 core: 区块下添加新字段：language: zh-CN

3、若文件中已存在 ui: 区块，在其下补充 locale: zh-CN；若不存在，则新增如下内容：

ui:

locale: zh-CN

prompt_style: chinese

4、保存文件后，退出当前终端会话并重新启动一个新的终端窗口。

三、替换内置提示模板为中文版本

该步骤覆盖 Hermes 默认的英文 system prompt、help 文本与斜杠指令说明，确保所有交互上下文均以中文呈现。所有模板文件位于 ~/.hermes/templates/ 目录，需按命名规则逐项替换。

1、进入模板目录：cd ~/.hermes/templates

2、检查是否存在 help_zh-CN.yaml 和 system_zh-CN.yaml。若不存在，从官方仓库下载对应文件：curl -o help_zh-CN.yaml https://raw.githubusercontent.com/NousResearch/hermes-agent/main/templates/help_zh-CN.yaml

3、执行命令将默认模板软链接指向中文版本：ln -sf help_zh-CN.yaml help.yaml

4、同理，对 system.yaml 执行：ln -sf system_zh-CN.yaml system.yaml

5、验证链接是否正确：ls -l help.yaml system.yaml，输出中应显示 -> help_zh-CN.yaml 等指向关系。

四、重写 skills/core.yaml 中的中文技能描述

该步骤确保内置核心技能（如 chat、search、file）在 /help 列表及技能调用时显示中文名称与说明，而非原始英文字符串。Hermes 在加载 skills 时会优先读取 description_zh 字段。

1、打开 ~/.hermes/skills/core.yaml 文件。

2、定位到每个 skill 定义区块（如 chat:），在其下添加或修改 description_zh: 字段，例如：

chat:

description_zh: 启动多轮对话会话，支持上下文记忆与模型切换

3、对 search:、file:、shell: 等其余技能重复该操作，确保每项均有对应中文描述。

4、保存文件后，执行 hermes reload skills 命令强制刷新技能元数据。

五、验证中文界面是否生效

该步骤通过 CLI 实时交互确认全部配置已正确加载，包括启动横幅、help 输出、错误提示及斜杠指令响应。所有文本应无乱码且语义完整。

1、在终端中输入：hermes --version，观察输出中是否含中文字符（如“版本”、“已就绪”）。

2、运行：hermes chat，进入会话后输入 /help，检查列表项是否为中文标题与说明。

3、尝试触发一个不存在的指令，例如 /xyz，确认错误提示为 “未识别的指令，请输入 /help 查看可用命令” 而非英文原文。

4、输入 /model list，确认模型名称列显示为 “通义千问”、“DeepSeek-V3”、“Kimi” 等中文别名（若已配置别名映射）。