Walter's Blog

主题

Hermes Windows Desktop 实战 ​

结论 ​

当前电脑实际运行的是 Hermes Agent CN Desktop，不应直接套用 Linux/TUI 教程。所有判断应同时检查桌面版路径、实际 CLI 输出和当前配置。

一、当前环境快照 ​

本次检查结果：

text
Hermes Agent：v0.19.0-cn.7 (2026.8.18)
Hermes Home：D:\software\hermes\Hermes Agent CN Desktop\data\hermes-home
CLI：D:\software\hermes\Hermes Agent CN Desktop\data\desktop-bin\hermes.bat
模型：gpt-5.6-sol
Provider：custom:172-16-3-6-8589
Web backend：Firecrawl
Memory provider：Hindsight
Approvals：smart
MCP：未配置
Skills：67 enabled（62 builtin + 5 local）

NOTE

这是检查时的本机状态，不是 Hermes 的固定默认值。升级或修改配置后应重新执行命令。

二、PowerShell 调用方式 ​

当前 CLI 不一定在系统 PATH，建议定义会话函数：

powershell
function hermes {
    & "D:\software\hermes\Hermes Agent CN Desktop\data\desktop-bin\hermes.bat" @args
}

然后检查：

powershell
hermes --version
hermes status --all
hermes config check
hermes doctor
hermes tools list
hermes skills list
hermes mcp list

三、当前配置评价 ​

已经合理的部分 ​

  • 模型和 Provider 已正常配置。
  • Web 搜索和提取统一使用 Firecrawl，避免搜索入口混乱。
  • Hindsight Memory 已启用。
  • 审批模式为 smart，比完全关闭审批更稳妥。
  • Secret redaction 使用默认开启状态。
  • 日常需要的文件、终端、搜索、Skills、Delegation、Todo 等 Toolsets 已启用。

需要优先整理 ​

  1. config.yaml 中存在模型 API Key 字段：虽然读取时会脱敏，但仍建议确认实际 Secret 是否可迁移到 .env 或桌面版安全凭据机制。
  2. MCP 当前为空：不要根据旧笔记写“已启用 Exa MCP”。如需接公司 DevOps，可从 OpenCode 已验证连接的 devopsmcp.exe 开始，但要重新为 Hermes 配置和测试。
  3. Skills 笔记数量已过时：当前是 67 enabled，不再是 64。
  4. Toolsets 较多：computer_use、image_gen、kanban 等不常用能力可按实际频率决定是否常驻。
  5. 配置文件含大量模板注释：保留有帮助，但长期维护时应把本机决策和默认示例分开。

四、推荐本机分层 ​

text
default Profile
├── 日常笔记、研究、文件操作
├── Firecrawl Web
├── Hindsight Memory
└── smart approvals

work Profile（建议新增）
├── 公司 Provider
├── DevOps MCP
├── 公司项目 Skills
├── 更严格的写操作审批
└── 独立会话和记忆

这样可避免公司系统凭据、业务记忆和个人笔记混在同一 Profile。

五、推荐启用的核心 Skills ​

日常常驻关注：

text
hermes-agent
obsidian
opencode
plan
systematic-debugging
requesting-code-review
documentation-repository-audit
tool-output-synthesis

其余 Skill 按任务加载，不需要为了“完整”逐个配置。

六、接入公司 DevOps MCP 的建议 ​

OpenCode 当前已能连接：

text
D:\data\project\ai-agent\gh-sdd\devopsmcp.exe

迁移到 Hermes 前：

  1. 先查看该程序支持的环境变量和工具清单。
  2. 不把用户名和密码直接写进公开笔记。
  3. 在 work Profile 中配置。
  4. 先测试列表、详情和状态类工具。
  5. 创建 Issue、触发 Pipeline 等写操作保持审批。
  6. 用 hermes mcp list 和 hermes mcp test <name> 验证，不以配置文件存在作为成功标准。

七、桌面版变更验证 ​

每次修改后执行：

text
1. 保存配置
2. 完全退出 Desktop 和托盘进程
3. 重新启动
4. 新建会话
5. 查看实际工具清单
6. 完成一个最小真实任务
7. 检查日志是否有权限、连接或 Secret 问题

八、本机笔记维护规则 ​

  • “版本、MCP 状态、Skill 数量、模型”必须标记检查日期或明确为当前快照。
  • 路径使用实际 Desktop 路径，不写错误的拼接目录。
  • 不把 CLI 不在 PATH 误判为 Hermes 未安装。
  • 不把 Desktop、TUI、Gateway 的界面和交付方式混为一谈。
  • 官方文档与本地 Skill 冲突时，以官方文档和当前命令输出为准。

相关笔记 ​

基于 MIT 许可发布

版权所有 © 2024-present Walter