在线阅读 · inferloop.dev/hermes-agent
所有书目 · inferloop.dev
这是一本关于 Hermes Agent 的解剖式技术书 + 完整的配套代码仓库。
正文请到 book/ 目录阅读,入口是 book/README.md。
.
├── book/ 正文(16 章 + 前言 + 8 附录,约 7700 行 Markdown)
│ └── assets/
│ └── skills-showcase/ 第 5 章 6 个明星 skill 的完整 SKILL.md
├── mini-hermes/ 第 15-16 章的完整 TypeScript 实现(可运行)
├── cases/ 第 14 章的三个端到端案例
│ ├── 01-repo-guardian/ 代码仓库守护者
│ ├── 02-research-assistant/ 研究助手
│ └── 03-knowledge-base/ 个人知识库助手
├── integrations/ 接入和工具(第 8、10、12 章配套)
│ ├── feishu-bot/ 生产版飞书 gateway(签名 / 解密 / 去重 / 卡片)
│ ├── feishu-bitable-mcp/ 飞书多维表格 MCP server
│ ├── morning-brief/ "每天早上主动汇报" 配置模板
│ ├── eval-runner/ 完整评估框架(LLM judge + A/B)
│ ├── dashboard/ 本地可观测 web 面板
│ └── alerts/ cron 告警脚本
├── feishu-setup/ 飞书开放平台接入指南和辅助脚本
├── scripts/ 维护者脚本(smoke-test、sync-to-wiki)
├── .github/workflows/ CI 配置(typecheck + bundle + markdown lint)
├── LICENSE 正文 CC BY-NC-SA 4.0 + 代码 MIT
├── CONTRIBUTING.md 贡献指南
├── CHANGELOG.md 版本变化记录
└── README.md 你正在读的这个
只想读书 —— 直接进 book/。
想跑 mini-hermes:
cd mini-hermes
bun install
cp .env.example .env # 填入 ANTHROPIC_API_KEY
bun run start # REPL 模式
bun run eval # 跑基础评估集
bun run gateway # 飞书 gateway(需要先配好 FEISHU_* 变量)想跑某个案例 —— 每个 case 目录下有自己的 README 说明部署流程。
想跑 integration —— 每个 integration 也有自己的 README 和 .env.example。
- 运行时:Bun 1.1+
- 语言:TypeScript(所有子项目都开
strict: true) - LLM:Claude(通过
@anthropic-ai/sdk) - 存储:SQLite(Bun 内置)+ 文件系统
- 协议:MCP(Model Context Protocol)
- 目标平台:飞书(gateway、Bitable、告警)
所有子项目都能 bunx tsc --noEmit 零错误通过,bun build 零警告 bundle。贡献前建议跑一次:
./scripts/smoke-test.sh会验证所有 7 个 TypeScript 项目 + book markdown 规范。CI 里跑的是同一套检查。
欢迎。流程见 CONTRIBUTING.md。
主要的贡献方向:
- 勘误:正文写错、代码跑不通、判断有偏差 → 开 issue 或直接提 PR 改
book/+book/appendix/G-errata.md - 新的 case / integration → 参考现有目录结构,先开 issue 讨论再提 PR
- mini-hermes 扩展:保持"教学友好"的前提下加功能,尤其欢迎向量检索、更严格的 skill 去重、更完整的可观测性
- 正文锁定 Hermes Agent 当前稳定版;上游迭代可能导致某些细节过时
- 所有已知的勘误记录在
book/appendix/G-errata.md - 代码版本历史见
CHANGELOG.md
本仓库同时包含两种 license:
| 内容 | License |
|---|---|
book/ 目录的正文 |
CC BY-NC-SA 4.0(禁止商用) |
| 其他所有代码和脚本 | MIT |
完整条款见 LICENSE。
- Nous Research 团队开源了 Hermes Agent 和高质量的源码注释,没有他们这本书不会存在
- 早期草稿阅读者指出了大量 AI 味段落和过度泛化的断言
- 飞书开放平台和
lark-cli工具链,让中文场景的接入变得可行
入口:book/README.md → 第 1 章《从 Chatbot 到 Agent》
来自同一作者的其他书: