# 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`。

---

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

```bash
# 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`（本机已开）＝低风险自动、高风险人工确认。

---

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

```bash
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（端点存活）
```