小马AI Hermes 中文增强包
为 Hermes Desktop、TUI 和 CLI 提供一条命令完成的中文补丁,按版本自动匹配,解决中文用户看不懂英文界面的问题。
- Star 数
- ★ 18
- 最近更新
- 3 个月前
- License
- MIT
- 主语言
- Shell
- FA 评分
- 证据不足
30 秒速览
- 可在哪里用
- 平台专用
- 开始前需要
- 典型场景
- 刚开始使用 Hermes、看不懂英文启动页和快捷指令的中文个人用户。
- 主要局限
- 仅适用于 Hermes 生态,对其他 Agent 框架没有作用。
- 官网
- useai.live/hermes ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-08-22最新版本 v2026.05.26.1(2026-05-27)
这个 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.json 和 latest.json;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.json 实现可选自动更新。
- 刚开始使用 Hermes、看不懂英文启动页和快捷指令的中文个人用户。
- 安装官方汉化后仍有部分界面(技能分类、网关状态、审批提示)显示英文的用户。
- 在 Windows、macOS、Linux 或 WSL2 上希望一条命令同时补装桌面端和中文补丁的新手。
- 使用 0.13.x–0.15.x 之外旧版本 Hermes、需要 legacy 兼容包的用户。
- 希望 Hermes 启动前自动检查并应用中文包新版本的重度用户。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 环境变量
XIAOMA_HERMES_BASE_URL- 配置文件
latest.json~/.xiaoma-hermes/bin/hermes- 安装说明涉及
- Windows · macOS
如何安装或部署这个 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.json,有新版本就先重新执行安装器:
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.json 自动升级中文包。
- 仅适用于 Hermes 生态,对其他 Agent 框架没有作用。
- 需要修改 hermes_cli、ui-tui 等程序文件,Hermes 升级后可能需要重装补丁。
- 安装和更新依赖 useai.live/hermes 在线页面与 latest.json,无法完全离线使用。
- 故障排查和版本适配信息主要在官网而非仓库内,仓库文档较薄。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| 小马AI Hermes 中文增强包 当前 | 证据不足 | — | ★ 18 | 3 个月前 | Shell | — |
| Agetor | 76 · 表现良好 | — | ★ 137 | 今天 | TypeScript | Codex · Claude Code |
| Hermes Agent CN Desktop | 55 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 1.9k | 今天 | TypeScript | — |
| Ordewell | 87 · 表现良好 | 命令行工具免费 + 模型费 | ★ 211 | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
- 源码中未见:最小权限约束只授予完成任务所需的权限:用专用账号或只读令牌,并限定可访问的目录和仓库。
- 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
- 源码中未见:数据流向说明运行时观察它连接了哪些外部服务(代理或防火墙日志);弄清数据去向之前不要输入敏感数据。
- 源码中未见:敏感信息处理使用专用、低权限、可随时吊销的 API 密钥,不要复用生产凭据,也不要让密钥出现在日志里。
- 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
- 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 源码中未见:来源归属可核验从官方仓库或包源安装,核对发布者和仓库地址,避免同名仿冒包。
- 当前材料不足以审查安装器和补丁包的实际行为;不要把文档中关于不读取对话或 API Key 的声明视为已由源码证实。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v2026.05.26.1 Hermes 中文增强包 2026.05.26.1:补齐网关用户可见中文
发布说明摘录
本版补齐主频道提醒、私信配对码、多会话话题、平台连接、网关服务和配对管理等用户可见中文。\n\n安装入口: https://useai.live/hermes/\n\n安装命令:\n\n``bash\ncurl -fsSL https://useai.live/hermes/install.sh | bash\n``在 GitHub 查看 ↗ -
v2026.05.19.2 Hermes 中文增强包 2026.05.19.2:一条命令安装中文补丁
发布说明摘录
Hermes Agent 中文用户可以直接用这一版安装中文增强包。 官网入口: https://useai.live/hermes/ 一句话安装: ```text 请访问 useai.live/hermes 安装汉化补丁 ``` 命令行安装: ```bash curl -fsSL https://useai.live/hermes/install.sh | bash ``` 这版重点: - 支持 Hermes Agent v0.14.x、0.13.x 和 legacy 老版本兼容路径。 - 覆盖启动页、TUI、快捷指令、工具分类、网关状态、ACP 权限、配对配置和审批提示。 - 没安装 Hermes 时,安装器会先安装官方版,再应用中文补丁。 - 有安装问题、版本适配、中文补丁未生效,或者想讨论 Hermes 在真实业务里的用法,请到官网首页扫码加入「Hermes交流答疑群」。 适合转发给: - 刚开始用 Hermes 的中文用户。 - 看不懂英文启动页和快捷指令的新手。 - 安装后仍有部分界面没有变成中文的人。在 GitHub 查看 ↗
常见问题
小马AI Hermes 中文增强包 官网是什么?
小马AI Hermes 中文增强包 开源吗?
小马AI Hermes 中文增强包 还在维护吗?
小马AI Hermes 中文增强包 是谁开发的?
谢谢反馈,我们会据此改进页面。