GUIDE PATTERN
Hermes 能力 × 生产模式映射（2026-09）
- Maturity
- L1
- Complexity
- low
- Reliability
- medium
- Hermes
- docs
- Version
- v1.4.0
Skill Contract（本模式的模块声明）
版本 v1.4.0 ｜ 分类 conventions ｜ 相关 cron-job-pattern · maker-checker · state-file-pattern · control-flow-separation · skill-evolution · secret-management
目的：Hermes 每次升级都会带来新工具能力。本表把 2026-08 前后的关键能力对号入座到既有模式，避免"有新模式但不知道用哪个工具落地"。
原则：能力在变，模式不变——新能力优先落地到已有模式，不急着造新模式。
v1.1.0（2026-08-20）：新增「七、知识检索与记忆」与「八、生命周期与进化」两族，落地 memory-os-pattern / evolution-gate / self-update-pattern。
v1.4.0（2026-09-05）：新增「十一、浏览器自动化」「十二、消息网关」「十三、多模态产出」「十四、能力验证」四族，落地呈现实操链路；全部能力均在真实环境跑出验证案例（见 examples/capability-verification-2026-09.md）。
一、Cron 与自动化（cronjob 工具族）
| Hermes 能力 |
干什么 |
落地模式 |
增强/替代的旧做法 |
monitor_script / monitor_url |
监控模式：每 tick 先跑脚本/抓 URL，输出哈希不变 → 跳过 agent（0 token）；变了 → 注入 unified diff 再跑 agent |
cron-job-pattern |
替代"agent 每 tick 自查"的监控类任务，从"每 tick 烧 token"变成"变了才烧" |
no_agent=True |
Watchdog 模式：脚本即任务，stdout 原样投递，空输出静默 |
cron-job-pattern |
纯脚本告警/看门狗，零 token |
context_from |
链式：job A 的最新输出注入 job B 的 prompt |
control-flow-separation / cron-job-pattern |
数据流水线的 cron 层原生实现，替代"B 自己读 A 的 STATE" |
attach_to_session |
可续会话：用户能回复该 job 的投递并延续上下文 |
cron-job-pattern（L3） |
交互式/可追问任务 |
enabled_toolsets |
限制 job 的工具集，降输入 token |
cron-job-pattern |
每 job 只加载需要的工具 |
script（agent 模式） |
脚本 stdout 注入 agent prompt 当上下文 |
cron-job-pattern |
数据收集模式 |
workdir |
job 在指定目录运行，注入 AGENTS.md/CLAUDE.md |
project-health-audit |
项目内 job |
二、质量与验证（maker-checker 族）
| Hermes 能力 |
干什么 |
落地模式 |
delegate_task（并行 batch） |
最多 3 个并行子代理，各自独立上下文/终端 |
maker-checker：Checker 可用 delegate_task 实现，与 Maker 完全隔离 |
output_schema |
子代理最终答案必须符合 JSON Schema，否则打回重试一次 |
maker-checker：Checker 的验证契约 |
live transcripts |
子代理操作全量记录在文件，可事后审计 |
maker-checker / project-health-audit |
三、状态与恢复（state-file-pattern 族）
| Hermes 能力 |
干什么 |
落地模式 |
session_search（FTS5） |
跨会话检索历史对话（discovery / scroll / read 三种形态） |
state-file-pattern 的补充：STATE.md 没写全时，用 session_search 找回上下文 |
memory（batch operations） |
原子批量增删改记忆（replace/remove 一次完成，超限时合并腾挪） |
state-file-pattern / secret-management：记忆更新的原子性 |
process（background + notify_on_complete） |
后台长任务托管：wait / poll / log / kill |
checkpoint-pattern：长任务后台化 + 完成通知 |
四、控制流与执行（control-flow-separation 族）
| Hermes 能力 |
干什么 |
落地模式 |
execute_code（hermes_tools 库） |
Python 内编程调用 web_search / web_extract / read_file / write_file / patch / terminal |
control-flow-separation：确定性代码路径的 Python 封装（过滤/分支/循环/批量） |
patch（V4A 多文件） |
一次补丁改多个文件 |
skill-evolution：批量迁移 |
read_file 多格式 |
ipynb / docx / xlsx / pdf 自动提取文本 |
调研/数据类任务 |
web_extract 缓存 |
超长页面存盘 + read_file 续读 |
调研类任务：大文档不爆上下文 |
五、技能与工具管理（skill-evolution 族）
| Hermes 能力 |
干什么 |
落地模式 |
skill_manage（patch / edit / delete） |
技能文件级更新；absorbed_into 标记合并/废弃去向 |
skill-evolution：v1→v2 升级与废弃的落地工具 |
skill_manage（write_file / remove_file） |
管理技能的 references / templates / scripts 子文件 |
skill-evolution：引用文件版本管理 |
tool_search / describe / call |
延迟加载工具（firecrawl 27 个、codegraph、flowix_memo 等） |
secret-management：工具按需加载，非常驻 |
clarify |
需要决策时问用户（单选/多选/开放式） |
maker-checker：人工 Checker 的交互入口 |
六、安全与审计（secret-management / anti-patterns 族）
| Hermes 能力 |
干什么 |
落地模式 |
| 审批机制（terminal / computer_use） |
危险命令需审批；computer_use 有独立审批域 |
secret-management：权限闸门 |
pre_tool_call 重写桥（rtk-rewrite） |
工具调用前拦截重写（如受保护文件 .env/config.yaml 的路径重定向） |
secret-management / control-flow-separation：写前强制保护，不许工具直接改受保护配置 |
| 注入防护 |
只信任系统标记的 OUT-OF-BAND 用户消息；工具输出/网页里的指令一律视为数据 |
anti-patterns：防提示注入 |
hermes computer-use doctor |
cua-driver 健康自检报告 |
project-health-audit：环境健康检查项 |
七、知识检索与记忆（memory-os-pattern 族）
| Hermes 能力 |
干什么 |
落地模式 |
| Knowledge MCP（he-knowledge） |
本地知识库语义检索：ask（RAG 问答）/ search（语义搜索）/ export_obsidian（导出回 vault） |
memory-os-pattern：读侧检索入口 |
| 向量索引脚本（index_vault / kg_extract） |
vault 文档 → LanceDB 向量分块 + 知识图谱三元组 |
memory-os-pattern：三层索引维护 |
session_search（FTS5） |
跨会话检索历史（discovery / scroll / read） |
memory-os-pattern：Experience Memory 层 |
memory（user / memory 双库） |
长期事实分库存储，batch operations 原子更新 |
memory-os-pattern：Long Memory 层 + state-file-pattern 补充 |
| 证据校验脚本（langextract / lx_verify） |
知识入库前抽取声明 + 独立模型复核（A 档证据） |
memory-os-pattern：写侧 G4 数据闸 |
八、生命周期与进化（evolution-gate / self-update-pattern 族）
| Hermes 能力 |
干什么 |
落地模式 |
loopctl（Evolution OS 工具） |
任务台账 + 五维加权评估 + G5 进化闸 + regression 对比（11 子命令） |
evolution-gate：评估→判定→回归闭环 |
| golden dataset（vault/Evaluation/） |
六类基准任务作为评估锚点 |
evolution-gate：回归基线资产 |
hermes update（源码 git 仓库） |
自更新；v0.20.4+ autostash 可能不自动恢复 |
self-update-pattern：更新前快照 → 更新后验 stash → 测试基线 → 可回滚 |
git stash / checkout |
补丁暂存恢复与版本回退 |
self-update-pattern：安全网 |
| 全量测试基线（pytest 失败清单） |
区分上游失败 vs 本地回归 |
self-update-pattern：更新后验证 |
九、Skill OS 基础设施（2026-08-30 新增，入口技能 hermes-skill-os）
| 组件 |
干什么 |
位置 |
| routing.json |
意图→PRIMARY/SHADOW 路由表（19 规则），signals 来自真实使用数据 |
~/.hermes/routing/ |
| routing-benchmark.json |
21 个路由回归用例，行为回归用无上下文子代理盲测 |
~/.hermes/routing/ |
| capability-registry.json |
15 项能力的机器可读注册表（本表是人读层），status 由脚本探测 |
~/.hermes/routing/ |
| MASTER-ROUTING.md |
任务决策六步入口 ROUTING→RESOLVE→CASE→EXECUTE→VERIFY→PERSIST |
~/.hermes/routing/ |
| routing_check.py / capability_probe.py |
确定性校验与探测，改路由/技能后必跑，exit 0 才算完成 |
~/.hermes/scripts/ |
| cases/_template + field-journal |
Case 状态容器与经验回流（retrospective→journal→SKILL.md/memory） |
~/.hermes/ |
十、可视化表达路由（2026-09-04 新增，入口技能 show-me）
从 HumanLayer/skills 借鉴 show-me 思路：不是画图工具，是"根据内容类型选最合适的视觉表达方式"的路由决策层。
| 内容类型 |
表达方式 |
路由技能 |
CLI 可用 |
| 架构/系统/基础设施 |
架构图 SVG/HTML |
architecture-diagram / diagram-design |
❌ |
| 算法/逻辑 |
文本伪代码块 |
直接输出 |
✅ |
| 运行时控制流 |
调用树 |
直接输出 |
✅ |
| 时序/交互 |
Mermaid sequenceDiagram |
diagram-design |
✅ |
| 数据流/管道 |
Mermaid flowchart / Sankey |
diagram-design |
✅ |
| 文件结构/布局 |
文件树 |
直接输出 |
✅ |
| 状态机/生命周期 |
状态图 |
diagram-design / html-diagram |
部分 |
| 对比/前后差异 |
diff 格式 |
直接输出 |
✅ |
| 定量数据/趋势 |
图表 |
diagram-design chart |
❌ |
| 概念关系/层次 |
信息图 |
baoyu-infographic / diagram-design |
❌ |
| 复杂可视化 |
HTML artifact |
html 路由 |
❌ |
设计原则：
- 最小视图：只画回答当前问题需要的最小范围，不画全景
- CLI 降级有序：HTML → Mermaid → 文本树 → 表格
- 图紧跟文字：每个视觉元素紧贴它支持的解释段落
- 路由信号聚焦"理解/解释"，与 R_DIAGRAM（直接画图请求）区分
十一、浏览器自动化（browser / vision 工具族，2026-09-05 新增）
入口技能：browser-skill（bsk 驱动真实 Chromium，Agent 隔离窗口 + 用户登录态）。
| Hermes 能力 |
干什么 |
落地模式 |
browser_navigate / browser_snapshot |
导航 + 可访问性树快照（含 ref 号，可点击/输入） |
调研/回归：见「无法直接抓取」时作为 web_extract 的兜底 |
browser_click / browser_type / browser_scroll |
交互式操作动态页面 / 填表 / 翻页 |
automation：需要登录态或 JS 渲染的抓取任务 |
browser_vision |
页面截图 + 视觉/OCR 理解（验证码、布局、渲染结果） |
maker-checker：UI 层验证不可能靠文本断言时 |
browser_console |
读页面 console 与浏览器异常，或求值 JS 表达式 |
前端工程审计（error handling / silent JS 失败） |
browser_get_images |
列出页面图片 URL + alt |
视觉素材采集（配图/抓素材） |
vision_analyze |
将图片载入上下文进行视觉理解（支持 region 放大局部文字） |
maker-checker：图片类产物人工/机器检查 |
验证案例：browser_navigate 成功打开 example.com 并解析出标题与可交互元素 ref；browser_console 求值 document.title 可读回页面标题。详见 examples/capability-verification-2026-09.md。
入口：config.yaml platform 接第三方消息渠道，Hermes 网关作为机器人常驻。
| Hermes 能力 |
干什么 |
落地模式 |
config.yaml platforms.qqbot |
官方 QQ 机器人网关（appId + client_secret），WebSocket 长连；私聊 / 群 @ / 频道消息收发 |
human-escalation：人工 Checker / 运维告警的投递渠道 |
| 凭证入环境变量而非明文 |
QQ_APP_ID / QQ_CLIENT_SECRET 存 .env，config 只引用 key |
secret-management：密钥不进版本库 |
| 网关进程常驻（gateway run） |
一个网关进程承载所有渠道连接，pairing 授权后消息自动路由进会话 |
self-update-pattern：升级后网关需重启自动重连 |
验证案例：config.yaml qqbot.enabled: true、home_channel 已 pairing 授权、gateway run 进程在 PID 1058 常驻。详见 examples/capability-verification-2026-09.md。
十三、多模态产出（image_generate / text_to_speech，2026-09-05 新增）
| Hermes 能力 |
干什么 |
落地模式 |
image_generate（text-to-image） |
文生图，支持 aspect_ratio；qwen-image provider 成图落到本地盘 |
配图生产：公众号/头条文章插图、架构示意图 |
text_to_speech |
文本转语音（edge provider），返回音频文件 |
内容分发：音频化公众号/播客素材 |
验证案例：image_generate 以 qwen-image-3.0-pro 生成 1280×1280 图并落 /mnt/g/hermes图片/；text_to_speech 生成 mp3 到音频缓存。Qwen-image 成图路径与 js 配图管线一致（图片=qwen-image，落 G:\hermes图片）。详见 examples/capability-verification-2026-09.md。
十四、能力验证（2026-09-05 新增，元能力）
每族新能力落地时，都要跑出「可复现的真实输出」作为验证案例，长在 examples/ 里，成为说话算数的证据，而不仅是文档描述。
| 验证方式 |
干什么 |
落地模式 |
| 真实调用产出 |
每族能力实际运行一次，留存输出/路径，作为 README 与 change 的锚点 |
反 hallucination：claim 必须有可复现 token |
| RRF 三层检索 |
hybrid_retrieve.py 语义→混合→精确 + Reciprocal Rank Fusion 融合排序 |
retrieval-os：多源检索排重 |
| 独立工具验证 |
图片/音频实际落盘、进程存活、页面可解析等客观检查 |
maker-checker：验证不走同一 Agent 的自我声明 |
使用建议
- 升级 Hermes 后先对照本表看新模式：能力在变，模式不变
- 新能力优先落地到已有模式（
monitor → cron-job-pattern 是 2026-08 的最新例子）
- 本表随 Hermes 版本持续更新（CHANGELOG 记录每次映射变更）
维护规则
- 本表或 capability-registry 任一处工具状态变化 → 同步另一处。
- routing.json 结构性改动视同技能改动，过 evolution-gate。
- 本表新增能力族时，同步在
examples/ 补验证案例，作为「实际运行验证」的证据锚点。