Agent 配套工具

hermes-zh-cn｜Hermes Agent 中文界面汉化补丁

hermes-zh-cn

面向中文用户的 Hermes Desktop、TUI 与 CLI 汉化补丁，通过官网安装器按版本匹配中文包并写入中文界面资源。

工程开发 本地部署中文界面
获取与使用

需要部署

按官方资料自行安装或部署

获取与使用 查看 GitHub ↗ 访问官方网站 ↗
使用难度待核验
国内可用性待核验

2026-11-09 更新 · 本站尚未实测

项目介绍

Agent 配套工具 · 2026-11-09 更新 · 本站尚未实测

Hermes 中文增强包（仓库名 fresh-claw/hermes-zh-cn）是给 Hermes 桌面版、Hermes Agent TUI 和 CLI 使用的中文界面补丁，面向看不懂英文启动页、快捷指令，或安装后仍有部分界面未汉化的用户。

按 README 描述，本项目提供的是「汉化补丁 + 安装器」，并不包含 Hermes 本体。Windows 入口会检测官方桌面端，缺少时调用官方桌面安装参数，再继续安装中文补丁；macOS、Linux 和 WSL2 入口会先检测本机 Hermes，未安装时自动执行官方安装脚本，再安装中文补丁。所有安装方式、系统要求和故障排查均以官网页面为准。

核心能力

点击能力名称查看输入、输出和原文依据。

  • 一句话触发安装：在 Hermes 对话中发送「请访问 useai.live/hermes 安装汉化补丁」，Hermes 读取页面说明后按官网指引安装。
  • 版本匹配：安装器 4 秒内检测本机 Hermes 版本，0.15.x、0.14.x、0.13.x 使用对应中文包，失败时回退 legacy 兼容包。
  • 界面汉化：备份后修改 hermes_cli/ 下的 banner、skin_engine、tips、commands、bundles、mcp_picker、secrets_cli，以及 acp_adapter/*.py、gateway/platforms/*.py、plugins/platforms/ntfy/plugin.yaml、ui-tui/src/**/*.ts 等文件，使启动标题、点阵标识、快捷指令、工具集、技能分类、网关状态、ACP 权限、配对配置与审批提示中文显示。
  • 语言配置：写入 display.language=zh，旧版 Hermes 命令不可用时直接更新 ~/.hermes/config.yaml。
  • 技能说明文件：写入 ~/.hermes/skills/xiaoma-hermes-zh/SKILL.md，让 Hermes 了解本项目的中文说明、边界和更新方式。
  • 安装校验：安装器校验包文件 SHA256 后，将内容安装到 ~/.xiaoma-hermes/current。
  • 可选自动更新：由 ~/.xiaoma-hermes/bin/hermes 包装命令在启动前检查 latest.json，有新版本时执行同一安装器再启动原 Hermes。

实际应用场景

适用场景

  • 刚开始使用 Hermes，希望启动页和提示信息为中文的用户。
  • 已安装 Hermes，但安装后部分界面仍为英文、需要补齐汉化的用户。
  • 在 Windows、macOS、Linux 或 WSL2 上希望一次性完成「本体 + 中文补丁」安装的用户。

本项目是本地化增强包，不是独立 AI Agent 框架，也不提供 Hermes 本身的能力。

安装与接入

按 README，推荐做法是在 Hermes 对话中直接发送：

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

Windows 由 web/install.ps1 提供 PowerShell 一键入口，macOS 提供 web/install.command 双击入口，脚本入口为 web/install.sh。README 仅给出本地测试时改写地址的示例：

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

安装器会下载并修改本地内容，操作前应阅读当前版本说明；本站未执行该安装流程。具体安装步骤、系统要求与故障排查以官网 https://useai.live/hermes 为准。本仓库未提供 MCP 服务配置或客户端连接配置，相关接入方式待核验。

使用条件与限制

是否需要部署
需自行准备运行环境，具体要求见正文
是否需要注册
账号和认证要求见正文；未明确说明的项目仍待核验
是否需要 API Key
待核验
费用与额度
费用边界见正文，项目许可不代表模型或托管服务免费
所需权限
待核验
许可证与服务条款
待核验

权限费用与限制

  • 安装器会修改本机已安装 Hermes 的源码文件（备份后进行），并写入 ~/.hermes/config.yaml、~/.hermes/skills/ 与 ~/.xiaoma-hermes/ 目录，属于较高权限的本地文件写入操作，安装前建议自行备份环境。
  • 汉化效果依赖 Hermes 版本；README 说明匹配 0.13.x 至 0.15.x，其他版本走 legacy 兼容包，具体覆盖范围与失效情况待核验。
  • 安装需要访问 useai.live 官网与下载包，存在境外/网络可达性依赖，实际连通情况待核验。
  • 本项目本身是否收费未在 README 说明；Hermes 本体及所调用模型的费用、额度与授权需向各自官方核实，待核验。
  • 汉化包会修改 Hermes 本机文件；对模型调用、密钥及数据流向的影响尚未独立核验，不据此承诺权限边界不变。

国内使用情况

网友核验 用户经验分享

与站长实测独立，不代表官方认证或本站已实测。

我要核验
0 位参与者0 份有效分项记录

最近核验：暂无有效核验。参与人数按当前项目有效身份去重；不同核验项分别统计，不合并成用户总结果。仅统计审核通过且未过期的记录。

分项统计、有效期与样本量
核验项目有效人数成功 / 部分 / 失败 / 无法判断成功率最近核验 / 有效期
官方网站访问00 / 0 / 0 / 0样本不足暂无 / 7 天
GitHub 仓库访问00 / 0 / 0 / 0样本不足暂无 / 7 天
安装与运行00 / 0 / 0 / 0样本不足暂无 / 30 天
官方服务国内连接 / MCP 连接00 / 0 / 0 / 0样本不足暂无 / 30 天
国内网络情况00 / 0 / 0 / 0样本不足暂无 / 7 天
国内模型兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
自定义 API00 / 0 / 0 / 0样本不足暂无 / 30 天
海外服务依赖
00 / 0 / 0 / 0样本不足暂无 / 30 天
海外账号要求
00 / 0 / 0 / 0样本不足暂无 / 30 天
中文界面
00 / 0 / 0 / 0样本不足暂无 / 30 天
客户端兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
账号及费用信息
00 / 0 / 0 / 0样本不足暂无 / 30 天

成功率 = 成功 ÷（成功 + 部分成功 + 失败）；无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项，成功表示核查结论与资料吻合，具体观察另行统计；不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。

最近有效核验

暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。

查看全部有效核验 →

国内实测状态：国内可用性待核验。协议兼容和官方资料说明不等于国内网络可用。

官方网站访问
尚未实测 待核验
GitHub 仓库访问
尚未实测 待核验
官方服务国内连接
尚未实测 待核验
国内网络情况
尚未实测 待核验
国内模型兼容性
尚未实测 待核验
自定义 API
尚未实测 待核验
海外服务依赖
尚未实测 待核验
海外账号要求
尚未实测 待核验
中文界面
尚未实测 待核验
国内最后核验时间
尚未实测

许可与国内使用

本仓库 LICENSE 文件为 MIT License（Copyright (c) 2026 Xiaoma AI），覆盖仓库内代码与脚本。安装器下载的中文包、官网托管页面、Hermes 本体及第三方模型/服务是否适用同一许可，需分别核实，待核验。公开仓库不代表相关在线服务免费或可境内直接使用；官网域名为 useai.live，不代表服务部署地域，实际可用性与合规性需自行确认。本仓库未见归档或停止维护的声明。

项目资料与来源

官方网站 ↗

GitHub 仓库 ↗

官方文档 ↗

字段依据与待核验事项

access：来源确认 · 请访问 useai.live/hermes 安装汉化补丁

project_type：来源确认 · 安装器写入 `~/.hermes/skills/xiaoma-hermes-zh/SKILL.md`，让 Hermes 知道本项目的中文说明、边界和更新方式。

原始 README（折叠技术参考）
# 小马AI Hermes 中文增强包

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

官网入口：[useai.live/hermes](https://useai.live/hermes/)

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

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

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

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

所有安装方式、系统要求和故障排查都以官网为准：[https://useai.live/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。

## 文件结构

```text
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     # 本地自检
```

## 本地测试

本地测试时可以改成：

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

## 多语言说明

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

- [English](README.en.md)
- [日本語](README.ja.md)
- [한국어](README.ko.md)
历史前置条件说明（补充参考）

需已安装或允许安装官方 Hermes（Windows 桌面端、macOS/Linux/WSL2 脚本安装）；需访问 useai.live 官网与下载包；安装器会修改本机 Hermes 源码文件并写入 ~/.hermes 与 ~/.xiaoma-hermes 目录，需本地文件写权限；模型/API Key 由 Hermes 本体管理，本项目未说明；本项目费用、Hermes 本体费用及模型费用均待核验；网络可达性与国内兼容性待核验。

项目来源与清单版权许可

https://github.com/fresh-claw/hermes-zh-cn

整理来源：https://github.com/slavakurilyak/awesome-ai-agents

清单版权与许可：

MIT License

Copyright (c) 2024 Slava Kurilyak

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.