小马AI Hermes 中文增强包

August 22, 2026 · View on GitHub

面向中文用户的 Hermes Desktop 桌面版、Hermes Agent TUI 和 CLI 汉化补丁。适合刚开始用 Hermes、看不懂英文启动页和快捷指令、或者安装后仍有部分界面没有变成中文的人。

官网入口：useai.live/hermes

遇到安装问题、版本适配、中文补丁未生效，或者想讨论 Hermes 在真实业务里的用法，可以扫码加入官网首页的「Hermes交流答疑群」。群里主要讨论业务落地和疑难杂症。

让用户在 Hermes 对话中发送一句话：

请访问 useai.live/hermes 安装汉化补丁

Hermes 读取页面说明后按官网指引安装。Windows 入口会检测官方桌面端；缺少时调用官方桌面安装参数，然后继续安装中文补丁。macOS、Linux 和 WSL2 入口会先检测本机 Hermes；未安装时自动执行官方安装脚本，安装完成后继续安装中文补丁。随后检测版本并使用匹配的中文包。

所有安装方式、系统要求和故障排查都以官网为准：https://useai.live/hermes。

机制

  1. useai.live/hermes 同时服务两类内容：人看的页面，以及 Hermes 可读取的正文、agent.json 和 latest.json。
  2. Hermes 执行一条安装命令；不要在安装前反复读取 JSON 或探测版本。
  3. 安装器自包含当前中文包；Windows、macOS、Linux 和 WSL2 都会补官方桌面端，再继续中文补丁安装。
  4. 安装器 4 秒内检测本机 Hermes 版本，0.15.x、0.14.x、0.13.x 使用对应包，失败时使用 legacy 兼容包。
  5. 安装器校验包文件的 SHA256 后，把中文增强内容安装到 ~/.xiaoma-hermes/current。
  6. 安装器设置 display.language=zh，旧版 Hermes 命令不可用时直接更新 ~/.hermes/config.yaml。
  7. 安装器检测 Hermes 程序目录，备份后修改 hermes_cli/banner.py、hermes_cli/skin_engine.py、hermes_cli/tips.py、hermes_cli/commands.py、hermes_cli/bundles.py、hermes_cli/mcp_picker.py、hermes_cli/secrets_cli.py、acp_adapter/*.py、gateway/platforms/*.py、plugins/platforms/ntfy/plugin.yaml、ui-tui/src/**/*.ts 等文件，并中文显示启动标题、原版风格点阵标识、快捷指令、工具集、技能分类、网关状态、ACP 权限、配对配置和审批提示。
  8. 安装器写入 ~/.hermes/skills/xiaoma-hermes-zh/SKILL.md，让 Hermes 知道本项目的中文说明、边界和更新方式。
  9. 可选启动更新由 ~/.xiaoma-hermes/bin/hermes 包装命令完成：启动前检查 latest.json，有新版本就执行同一个安装器，再启动原 Hermes。

文件结构

web/
  index.html                 # useai.live/hermes 页面
  details.html               # 详细说明页
  agent.json                 # Hermes 读取的任务清单
  latest.json                # 版本入口
  platforms.json             # Windows/macOS/Linux 入口和桌面版策略
  install.sh                 # 一键安装器
  install.ps1                # Windows PowerShell 一键入口
  install.command            # macOS 双击入口
  tools/xiaoma-hermes        # 更新与状态辅助脚本
  packages/0.15.x/zh-CN/     # Hermes 0.15.x 中文增强包
  packages/0.14.x/zh-CN/     # Hermes 0.14.x 中文增强包
  packages/0.13.x/zh-CN/     # Hermes 0.13.x 中文增强包
  packages/legacy/zh-CN/     # 旧版兼容包
scripts/check_release.sh     # 本地自检

本地测试

本地测试时可以改成：

XIAOMA_HERMES_BASE_URL=http://127.0.0.1:4173 bash web/install.sh

多语言说明

网站页面保持中文；其他语言说明仅在 GitHub 仓库提供：