Hermes Agent 部署 Deep Research — 指导书审校与修正版

审校日期：2026-09-12　｜　审校环境：macOS 26.5.2，本机 Hermes Agent v0.21.1 (2026.9.7)，Python 3.11.15 方法：逐条把指导书里的命令在本机真跑一遍，用实测输出判定，不凭印象。结论先说：框架和思路是对的，但 4 条命令在本机不存在（hermes run / hermes delegate / hermes run --skill / 裸名装技能），3 个 MCP 不在 Nous 目录里，安装 URL 在本机走不通。

一、勘误总表

#	章节	原文写法	判定	实测证据	修正
1	2.2 安装	`curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh \\| bash`	⚠ 本机不可达	该 URL 实测 HTTP 000（连接失败）；连 `.../main/README.md` 也是 000 → 是域名可达性问题，不是路径不存在	用官方通道：`curl -fsSL https://hermes-agent.nousresearch.com/install.sh \\| bash`（实测 200）
2	2.2 脚本路径真伪	`scripts/install.sh` / `scripts/install.ps1`	✓ 路径真实	本机 git 仓库 `ls-files` 实测存在：`scripts/install.sh`、`scripts/install.ps1`、`scripts/install.cmd`	路径没错，只是别用 raw.githubusercontent 域名
3	2.1 版本要求	Hermes ≥ v0.20.0	✓	本机 `hermes --version` → v0.21.1	另注意：本机已落后 upstream 810 commits，建议先 `hermes update`
4	3.2 模型名	`deepseek-v4-pro` / `deepseek-v4-flash`	✓ 真实	本机 model_catalog 内实测存在两者，另有 `deepseek-v4-flash-vision-exp`	无（保留）
5	3.3 手写 YAML	`model: {provider, default}` + `providers.deepseek.{base_url, api_key}`	⚠ 结构与本机实际不符	本机实际：`model: {default, provider, base_url, api_key}`；`providers` 下是命名档（deepseek/local/kimi/zhipu），deepseek 档字段为 `default_model` + `extra_body`，没有 `providers.deepseek.model`	别手抄 YAML：用 `hermes setup` 或 `hermes config set`；确需手改先 `hermes config show` 看当前结构
6	3.3 密钥存放	`~/.hermes/.env`，权限 600	✓ 正确	官方设计：`.env` 只放密钥，行为配置放 `config.yaml`	无
7	4.1 搜索	`hermes skills search "deep research"`	✓ 真实	实测返回 25 条结果	无
8	4.1 安装	`hermes skills install deep-research`	✗ 会歧义失败	`hermes skills inspect deep-research` 实测报 “Multiple skills named 'deep-research' found”，列出 20+ 个同名技能	必须给完整 identifier，例如 `hermes skills install clawhub/deep-research`（七阶段流水线）；官方替代：`official/research/parallel-cli`
9	4.3 验证	`hermes skills list`	✓ 真实	子命令存在	无
10	5 MCP 表	Scopus MCP / Exa Search MCP / NotebookLM MCP	⚠ 都不在官方目录	`hermes mcp catalog` 实测按 `scopus\\|exa\\|notebooklm\\|paper\\|scholar` 检索零命中（目录里相关的只有 hugging_face、context7、deepwiki）	需 `hermes mcp add` 手动接第三方 server；Exa 官方远程端 `https://mcp.exa.ai/mcp` 实测存活（HTTP 405，需 API key）。Scopus 未见官方 MCP
11	5 命令	`hermes mcp list` / `hermes mcp test <名称>`	✓ 真实	子命令 `list/install/catalog/test/add` 均存在	无
12	6.1 执行	`hermes run "..."`	✗ 不存在	实测 `hermes run "test"` 直接吐顶层 usage（无 run 子命令）	用 `hermes chat -q "..."`
13	6.1 带技能执行	`hermes run --skill deep-research "..."`	✗ 不存在	顶层命令表里无 `run`；`--skill` 也不是合法参数	正确：`hermes chat -q "..." -s deep-research`，或 `hermes -z "..." --skills deep-research`（`-q/--query`、`-s/--skills` 实测存在）
14	6.2 委托	`hermes delegate "..."` / `hermes delegate --parallel ...`	✗ 不存在	实测 `hermes delegate "test"` 同样只吐顶层 usage	委托是会话内工具 `delegate_task`（我日常在用），不是 CLI 子命令
15	6.2 并发上限	“最多 3 个并发”	⚠ 可配，本机不是 3	本机 `delegation.max_concurrent_children` = 10	改成“由 `delegation.max_concurrent_children` 决定（本机 10）”
16	6.2 子代理特性	独立上下文/工具集、结果摘要回传	✓ 正确	与 `delegate_task` 实际行为一致	无
17	7.3 排查	`hermes skills tap add <仓库地址>`	✓ 真实	子命令存在	无
18	7.4 排查	`hermes doctor`	✓ 真实	子命令存在	无
19	7.2 依赖	Python ≥ 3.10、可用 uv 管理	✓ 正确	本机 Python 3.11.15；官方 install.sh 头部自述 “Uses uv for desktop/server installs”	无
20	8 成本	`hermes config set approvals.mode smart`	✓ 真实	`hermes config set` 存在；本机 `approvals.mode` 已是 `smart`	无

一句话总结：这份指导书把“Hermes 的能力”写对了，把“Hermes 的 CLI”写错了——凡是 hermes <动词> 形式里带 run / delegate / --skill 的，都是想象出来的命令；真实入口是 chat -q/-s 与会话内 delegate_task。

二、修正版可执行步骤（本机实测）

# 0) 先看现状（本机已装，跳过安装）
hermes --version          # → v0.21.1 (2026.9.7)；落后 upstream 810 commits
hermes update             # 建议先升级（可选）

# 1) 模型配置（别手抄 YAML）
hermes setup                              # 向导：Provider=DeepSeek，Base URL=https://api.deepseek.com
hermes config get model                   # 复核实际结构
hermes -z "你好，请用中文回复"             # 3.4 的验证（chat -q 亦可）

# 2) 找到并安装技能（关键：必须用完整 identifier）
hermes skills search "deep research"                       # 25 条结果
hermes skills inspect clawhub/deep-research                # 先预览（community 信任）
hermes skills install clawhub/deep-research                # 或用 official/research/parallel-cli
hermes skills list                                         # 验证

# 3) MCP（Scopus/Exa/NotebookLM 都不在目录里，只能手动接）
hermes mcp catalog | grep -iE "hugging|context7|deepwiki"   # 目录里现有可用的
hermes mcp add                                              # 手动加第三方 server（需对方 API key）
hermes mcp list && hermes mcp test <名称>

# 4) 真正调用（取代指导书的 hermes run）
hermes chat -q "用 deep-research 流程调研：2025 年 AI Agent 在生物医药的进展" -s deep-research
hermes -z "同样的问题" --skills deep-research               # 等价写法

# 5) 排查
hermes doctor
hermes config check

三、与宝锐现有能力的对照（真正的增量在哪）

本机已经有一套跑通的深度调研流水线，不必从零装：

能力	本机现状
技术文献深调研（七阶段：搜索计划→全文抓取→结构化草稿→校验→导出）	已有：`baoyu-technical-literature-deepdive` 技能，A 档 4 条已交付（含 4 份草稿、证据账、HTML）
开放获取全文获取（DOI→合法全文）	已有：`baoyu-literature-access` 技能；本地 OA 全文 40 篇、判定链 57 DOI→36 有全文→真封闭 24 篇
学术检索入口	缺：目前只有 Unpaywall / Europe PMC / Crossref，没有全网学术搜索（Exa 类）与引文库（Scopus 类） —— 这正是接 MCP 能补的一块
子代理并行研究	已有：`delegate_task`（本机并发 10），本轮已用 4 并行子代理回填

建议：这个技能对宝锐的实际增量 = ① 学术检索 MCP（Exa 等） + ② 别人的七阶段流水线做交叉参照。装之前先 hermes skills inspect 看清它依赖哪些工具，避免装一个“要 Scopus 订阅才能跑”的空壳。

四、安全与成本（指导书这部分基本正确，补两点）

API Key：不要硬编码。hermes setup 写入 ~/.hermes/.env（本机 .env 只存密钥），权限 600；本报告不记录任何密钥明文。
成本：日常用 deepseek-v4-flash，复杂推理切 deepseek-v4-pro（本机两个模型名均真实）。
第三方技能信任：clawhub/* 与 skills-sh/* 是 community trust（非 official）。安装后可用 hermes skills audit 复扫；不放心就选 official/research/parallel-cli。
审批闸门：approvals.mode=smart（本机已开）＝低风险自动、高风险人工确认。

附：审校所用实测命令（可复核）

hermes --version
hermes --help | head -60
hermes chat --help | grep -E "^-? *(-q|--skills)"
hermes skills search "deep research"
hermes skills inspect deep-research
hermes mcp catalog | grep -iE "scopus|exa|notebook|paper|scholar"
curl -s -o /dev/null -w "%{http_code}" -L https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh   # 000
curl -s -o /dev/null -w "%{http_code}" -L https://hermes-agent.nousresearch.com/install.sh                                   # 200
git -C ~/.hermes/hermes-agent ls-files | grep -E "^scripts/install"    # install.sh / install.ps1 / install.cmd
curl -s -o /dev/null -w "%{http_code}" -L https://mcp.exa.ai/mcp      # 405（端点存活）