小马AI Hermes 中文增强包
为 Hermes Desktop、TUI 和 CLI 提供一条命令完成的中文补丁，按版本自动匹配，解决中文用户看不懂英文界面的问题。
- Star 数
- ★ 16
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- Shell
- FA 评分
- 36/100 · 缺口较多
30 秒速览
- 可在哪里用
- 平台专用
- 开始前需要
- 典型场景
- 刚开始使用 Hermes、看不懂英文启动页和快捷指令的中文个人用户。
- 主要局限
- 仅适用于 Hermes 生态，对其他 Agent 框架没有作用。
- 源码审查
- 36/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
小马AI Hermes 中文增强包（fresh-claw/hermes-zh-cn）是一套针对 Hermes Desktop、Hermes Agent TUI 和 CLI 的汉化补丁及配套安装器。用户在 Hermes 对话中发送一句安装指令，Hermes 会读取 useai.live/hermes 页面并按官网指引执行安装。安装器先检测或补装官方桌面端，4 秒内识别本机 Hermes 版本，为 0.15.x、0.14.x、0.13.x 选用对应中文包，失败时回退到 legacy 兼容包。校验 SHA256 后，补丁安装到 ~/.xiaoma-hermes/current，并备份后修改 hermes_cli/banner.py、skin_engine.py 等程序文件和 ui-tui 源码，实现启动页、快捷指令、网关状态、审批提示等界面中文化。项目以 MIT 许可开源，支持 Windows、macOS、Linux 和 WSL2。
项目由 web/ 下的安装入口与 packages/ 下的各版本中文包组成。流程是：Hermes 读取 useai.live/hermes 页面中的正文、agent. 和 latest.；Windows 入口（install.ps1）检测官方桌面端，缺少时调用官方安装参数；macOS（install.command）、Linux 和 WSL2 入口（install.sh）检测本机 Hermes，未装时自动执行官方安装脚本。随后安装器检测版本并匹配 packages/0.15.x、0.14.x、0.13.x 或 legacy 的 zh-CN 包，校验 SHA256 后安装到 ~/.xiaoma-hermes/current，设置 display.language=zh（或直接更新 ~/.hermes/config.yaml），并备份修改 hermes_cli/banner.py、skin_engine.py、tips.py、commands.py、bundles.py、mcp_picker.py、secrets_cli.py、acp_adapter/*.py、gateway/platforms/*.py、ui-tui/src/**/*.ts 等文件。它还写入 ~/.hermes/skills/xiaoma-hermes-zh/SKILL.md，并通过 ~/.xiaoma-hermes/bin/hermes 包装命令在启动前检查 latest. 实现可选自动更新。
- 刚开始使用 Hermes、看不懂英文启动页和快捷指令的中文个人用户。
- 安装官方汉化后仍有部分界面（技能分类、网关状态、审批提示）显示英文的用户。
- 在 Windows、macOS、Linux 或 WSL2 上希望一条命令同时补装桌面端和中文补丁的新手。
- 使用 0.13.x–0.15.x 之外旧版本 Hermes、需要 legacy 兼容包的用户。
- 希望 Hermes 启动前自动检查并应用中文包新版本的重度用户。
如何安装或部署这个 Agent？
推荐方式是在 Hermes 对话中发送一句话，由 Hermes 读取官网页面并自动安装：
text
请访问 useai.live/hermes 安装汉化补丁
也可以直接在终端执行一键安装脚本：
bash
bash web/install.shWindows 使用 PowerShell 入口 install.ps1，macOS 可双击 install.command。所有安装方式、系统要求和故障排查以官网为准：https://useai.live/hermes
如何使用这个 Agent？
安装完成后，补丁将 display.language=zh 写入配置，重启 Hermes 后启动标题、快捷指令、工具集、网关状态等界面即显示中文。可选的自动更新通过包装命令完成，启动前会检查 latest.，有新版本就先重新执行安装器：
bash
~/.xiaoma-hermes/bin/hermes本地测试时可改用本地基址：
bash
XIAOMA_HERMES_BASE_URL=http://127.0.0.1:4173 bash web/install.sh这个 Agent 有哪些优点和局限？
- 一条命令覆盖 Windows、macOS、Linux 和 WSL2，缺桌面端时自动先补官方安装。
- 按 Hermes 版本（0.15.x/0.14.x/0.13.x/legacy）匹配中文包，失败时自动回退兼容包。
- 安装前校验 SHA256，修改程序文件前先备份，降低补丁风险。
- 通过 SKILL.md 和包装命令内置更新机制，可随 latest. 自动升级中文包。
- 仅适用于 Hermes 生态，对其他 Agent 框架没有作用。
- 需要修改 hermes_cli、ui-tui 等程序文件，Hermes 升级后可能需要重装补丁。
- 安装和更新依赖 useai.live/hermes 在线页面与 latest.，无法完全离线使用。
- 故障排查和版本适配信息主要在官网而非仓库内，仓库文档较薄。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| 小马AI Hermes 中文增强包 当前 | 36 · 缺口较多 | — | ★ 16 | 1 个月前 | Shell | — |
| Hermes Agent CN Desktop | 41 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 1.7k | 6 天前 | TypeScript | — |
| senpi | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 453 | 今天 | TypeScript | OpenAI API · Claude API |
| zot 编码代理 | 59 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 345 | 2 天前 | Go | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据仅来自 README 与 LICENSE，安装脚本 web/install.sh 本体未提供。README 声称安装器会'检测版本、安装官方 Hermes、打补丁、设置启动更新助手'，这涉及修改用户本地 Hermes 安装并触发网络下载，但无代码可验证其权限范围；'启动更新助手'属于常驻外部效果，风险未知。'不读取对话/API 密钥'等边界声明无代码支撑。打补丁是否可回滚仅有一处 'backed-up patches' 的模糊表述。来源归属仅指向 unverified 的 Xiaoma AI 与外部站点 useai.live。扣分：所有信任相关声明均无实现文件佐证，且核心安装流程要求 Agent 依据外部网页指引执行命令。
README 描述对 0.2–0.15 多版本的覆盖与文件清单基本自洽，但版本矩阵存在矛盾：描述称支持 'v0.14.x、v0.13.x 和 legacy'，覆盖清单又称支持 '0.15.x'，且实际安装细节不可验证。依赖（官方 Hermes 安装器、网络页面）可用性无从评估。安装失败时的错误信息完全无证据，计 0。扣分：自洽性受版本表述冲突与不可验证的实现影响。
受众明确（中文 Hermes 用户），多版本覆盖（0.2–0.15）显示一定场景广度，计 2。能力边界仅在 Boundaries 一节有否定式声明，未说明补丁失败或版本不匹配时的行为。触发方式依赖 Agent 解析一句自然语言并访问外部页面，触发精确度与环境适配（操作系统、Hermes 安装路径）均无证据。扣分：边界、触发与环境适配缺乏可检验描述。
文件结构清单清晰，中英文双 README，信息组织尚可，计 2。安装说明指向外部网站，仓库内无可审阅的安装步骤。命名在 'Hermes Chinese Enhancement Pack' 与 '汉化补丁' 之间一致性一般。无 FAQ，无已知局限章节（Boundaries 只是安全声明而非功能局限）。LICENSE 为 MIT 但标注 'Copyright (c) 2026'，年份可疑。无 CHANGELOG；latest. 未提供内容。维护责任（更新节奏、回应渠道）无证据。扣分：除结构外的各约定项均缺直接材料。
输出效果（界面汉化）仅在描述层面可见，无截图或补丁文件示例，输出可用性计 1。边际价值真实存在——官方 Hermes 语言设置未覆盖部分文案，此价值清楚，计 2。成本收益方面，用户需让 Agent 执行一条指向第三方未验证站点的安装流程，换取 UI 文本翻译，风险与收益不对称且无证据支持，计 1。扣分：收益主张全部未经验证。
核心声明（版本检测、补丁应用、不读密钥）在提供的文件中无任何代码、测试或补丁文件可追溯，claim_traceability 计 0。无第二来源可交叉印证，计 0。README 中事实描述与边界声明有分节，但边界声明混入无法验证的安全断言，计 1。扣分：几乎全部关键主张不可静态核实。
- 安装流程依赖 Agent 读取第三方站点 useai.live 的指引并执行命令，而安装脚本本身不在可审阅范围内，属高风险供应链路径，建议在审查 web/install.sh 与补丁内容前不要安装。
- README 中'不读取对话/API 密钥'等安全边界仅为声明，无代码佐证，不应据此信任。
- '启动更新助手'为常驻外部效果，其网络行为与更新来源未披露。
- 未验证发布者 + 版权年份标注为 2026，需进一步核实项目身份与时间线。