6. 综合练习：配一个能用的 Hermes Agent
这是什么：实战配置 = 把前五章组装成一个属于你的助手：有模型、工具、技能、插件。
为什么用：读过五章和真正配好一个 Agent 是两回事。配错了你只会觉得「它不好用」，却说不清卡在哪一步——这份清单就是用来定位问题的。
如何用：本章按「装 → 配 → 跑 → 养 → 扩」五步走一遍，最后用验收表逐项自查。
6.1 先定目标
动手指之前，先用一句话写下目标：
「能读仓库、跑测试、按我写的流程提 PR；云端调用能一键切回云端模型的助手。」
每个名词都会变成配置项。目标越糊，配出来越像流水线。
6.2 第一步：装
# Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# Windows 原生（PowerShell）
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
装完开一个新终端，跑 hermes --version 和 hermes doctor。后者要过，它会告诉你缺什么。这步没过后面都白搭。
6.3 第二步：配模型
省事路线（推荐第一次）：hermes setup --portal
自带 Key：hermes model → 选提供商 → 粘贴 Key → 挑模型 → 保存。
完全本地：hermes setup → 选 Custom Endpoint，Base URL 填 http://localhost:11434/v1，Key 留空，Model 填 ollama pull 过的模型。
配完立刻验证：
hermes config get model.default # 模型名对不对
hermes config get model.provider # 提供商对不对
📏 无论哪条路，模型上下文必须 ≥ 64K，否则启动被拒。本地模型记得调大
num_ctx。
6.4 第三步：跑通并验证
hermes
进去后做一个三连测，每步对应一类故障：
| 测试 | 输入 | 期望 | 测什么 |
|---|---|---|---|
| 能力测 | 「读 README，三句话概括」 | 能读并回答 | 文件工具 + 连通 |
| 动手测 | 「建 hello.py 打印并运行」 | 能建并执行 | 终端工具 + 审批 |
| 记忆测 | 退出后 hermes -c |
历史还在 | 会话持久化 |
三个都过，底子才算稳。这时候再往上加功能，否则分不清锅。
6.5 第四步：养一个技能
选一件你每周做两次以上的事写成技能。
mkdir -p ~/.hermes/skills/my-weekly-flow
然后写 ~/.hermes/skills/my-weekly-flow/SKILL.md：
---
name: my-weekly-flow
description: 每周发布例行检查清单：跑测试、生成变更日志、通知团队
version: 1.0.0
metadata:
hermes:
tags: [release]
category: workflow
---
# My Weekly Flow
## When to Use
用户说「发例行」「走发布流程」时。
## Procedure
1. `pytest -q`
2. `git log --oneline v1.2.0..HEAD > CHANGELOG.md`
3. `hermes send --to telegram "例行发布完成"`
## Pitfalls
- 测试失败时不要继续，先修
- 变更日志要带上 issue 号
## Verification
CHANGELOG.md 里每条都有 issue 号。
写完在会话里试：/my-weekly-flow。也可以让 Agent 自己写——你做一遍流程后说「把这步骤写成技能」。
再往上一步，挂几个现成的技能：hermes skills search github，再 hermes skills install openai/skills/k8s。
6.6 第五步：加一个插件或 MCP
想接现成生态 → MCP。在 ~/.hermes/config.yaml 里：
mcp_servers:
github:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"
tools:
include: [list_issues, search_code] # 只放行只读工具起步
想接私有系统 → 写插件。建 ~/.hermes/plugins/my-plugin/，照第 5 章模板写，别忘了启用：
hermes plugins enable my-plugin
🔒 插件默认是关的。这不是 bug，是安全设计。
最后把界面换成浏览器：hermes dashboard 打开 http://127.0.0.1:9119，能可视化改配置、管 Key、看会话。但它默认只绑本机、且没有鉴权，别暴露到公网。
6.7 验收清单
| # | 项目 | 命令 / 位置 |
|---|---|---|
| 1 | 装好了 | hermes --version |
| 2 | 体检通过 | hermes doctor |
| 3 | 模型配好 | hermes config get model.default |
| 4 | 上下文 ≥ 64K | 后台或 num_ctx |
| 5 | 能读文件 | 问它 README |
| 6 | 能跑命令 | 建文件运行 |
| 7 | 会话能恢复 | hermes -c |
| 8 | 技能装在位 | ~/.hermes/skills/ 有它 |
| 9 | 技能能调用 | /my-weekly-flow |
| 10 | 插件已启用 | hermes plugins list |
| 11 | MCP 已加载 | /tools 能看到 mcp_* |
| 12 | 密钥在 .env |
不在 config.yaml |
6.8 翻车速查
| 症状 | 怎么办 |
|---|---|
| 说不出话 | hermes model 重配 |
| 聊天但不动手 | 换支持工具的模型 |
| 本地模型很慢 | 调大 num_ctx，设 HERMES_API_TIMEOUT |
| 插件装了没反应 | hermes plugins enable <name> |
| MCP 工具看不见 | 查 mcp_<服务器>_<工具> |
| 更新后配置丢失 | hermes config check → migrate |
| 换机器想重来 | hermes backup → hermes import |
动手改
- 按 6.7 的清单过一遍，每项标上 ☑ 或 ✗。
- 为每个 ✗ 找排查命令，解决后重测——这就是 Hermes 的工作循环。
- 导出跑通的配置：
hermes backup（整份数据），或hermes profile export（单个 profile）。
小结
- 五步走：装 → 配模型 → 三连测 → 养技能 → 加插件/MCP
- 顺序别乱：底子没稳别加功能
- 三连测（读文件 / 跑命令 / 恢复会话）是最小基线
- 技能写「When to Use + Procedure + Pitfalls + Verification」
- 插件默认禁用，要
hermes plugins enable - 上下文 64K 是硬门槛，密钥只放
.env
恭喜，你有了个会自己长本事的助手。
它的价值在于它把你的经验留下来了。
接下来值得玩：接到 Telegram 上随时待命（hermes gateway setup），或从 Skills Hub 挑几件手艺。
祝你玩得开心 🐸