怎么读¶

四种身份的推荐路径¶

🧑‍💻 只想体验一下🎯 日常重度用户🛠️ 开发者 / 贡献者🔬 科研同学

目标:1 小时内装好、聊一次、判断它是不是我想要的。

停在这里。觉得喜欢再继续往下。不喜欢也没损失 —— 你已经拥有了判断它的完整信息。

目标:把 Hermes 装进自己生活,在 Telegram / Discord / Slack 里指挥它,有定时任务,有技能,有记忆。

路径: 1. 完整读完 第一部 · 入门 2. 完整读完 第二部 · 日常 —— 切模型、技能、记忆、会话搜索 3. 完整读完 第三部 · 精通 的前三章 —— 消息网关、定时任务、Profile

剩下的按需翻。遇到具体问题再去查附录里的 CLI 参考和故障排查。

目标:给 Hermes 加工具、加命令、加平台适配器,或者 fork 一份改造。

路径: 1. 第 0 层 · Hermes 是什么 —— 只需要大局观 2. 第 1 层 · 五大支柱 —— 建立心智模型 3. 直接跳 第四部 · 内核 —— 架构、agent loop、工具注册机制、Profile 工作原理 4. 按需回头看前几部里用得上的场景

重要

写代码前先通读 第四部 开头的「重要策略」—— prompt caching 的边界、profile-safe 代码规则、已知坑点。这些是项目维护者已经踩过的坑,别再踩一次。

目标:用 Hermes 做 agent 轨迹生成、RL 训练、工具调用模型评估。

路径: 1. 第 0 层 · Hermes 是什么 —— 建立大局观 2. 第 1 层 · 五大支柱 —— 知道数据从哪流出 3. 直接跳 第五部 · 研究 —— 批处理、Atropos 环境、轨迹压缩 4. 附录里的术语表随手查

冲刺式(适合决策场景)

只读第 0-1 层(Hermes 是什么 + 五大支柱),大约 30 分钟。用来决定「要不要在团队里推这个东西」或者「这个项目跟我想做的事有没有关系」。

周末集中式(适合建立系统认知)

一个完整周末读完第一、二部,动手把第一部的所有命令跑一遍,第二部挑 2-3 个场景亲自走通。周末结束你就是合格的重度用户。

按需查阅式(适合已经在用了)

不用按顺序读。遇到具体问题,用站内搜索(右上角 🔍)找关键词。这本书的每一节都能独立读,不靠前文背景。

这本书用了一些固定的视觉约定:

绿色提示 —— 最佳实践

值得照做的做法。

黄色警告 —— 坑点

作者或项目维护者踩过的坑,可以绕开。

红色危险 —— 会出事

这样做会损坏数据/配置/缓存/账号,不要试。

蓝色信息 —— 背景知识

不影响读下一段,但知道了更有趣。

紫色问题 —— 思考题

请先自己想一下,再往下看答案。读得更深。

# 代码块里带 $ 或 > 前缀的是 shell 命令
$ hermes --help
> hermes model

# 不带前缀的是代码
def example():
    return "Python / Hermes 源码"

发现错误、有补充建议、想加一章、想署名翻译 —— 都欢迎: