前言

Hermes Agent 是 Nous Research 开源的 self-improving AI agent。它不是又一个"对话 + 工具调用"的演示项目，而是一个可以 7×24 运行在 $5 VPS 上、通过 Telegram 和你对话、从工作经验中自动提炼技能、越用越懂你的个人工作代理。

这本书不是使用教程——Hermes 已经有完整的官方文档。这本书要回答的问题是：构建这样一个 self-improving personal agent，在工程上需要解决哪些问题，Hermes 做了什么选择？

全书以 Hermes 的四个核心设计赌注为分析框架：

Learning Loop — agent 从经验中创建技能、自我改进、主动持久化知识
CLI-First — 终端是第一等公民，不是 Web UI 的附庸
Personal Long-Term — 跨会话记忆、用户建模、越用越懂你
Run Anywhere — 从 $5 VPS 到 GPU 集群，从本地到 Telegram

每一章的分析都会回扣到至少一个设计赌注，帮助读者理解具体的工程决策为什么是这样的。

阅读准备

前置知识

Python：能读懂 Python 3.11+ 代码，了解 async/await、装饰器、ABC
LLM 基础：了解 system prompt、tool calling、context window 等基本概念
CLI/服务端：了解进程管理、SQLite、HTTP API 的基本概念
不需要：不需要了解 Hermes 的使用方法，不需要机器学习背景

全书知识地图

graph TD
    subgraph "第一部分：为什么是 Hermes"
        CH01[Ch01 设计赌注]
        CH02[Ch02 仓库地图]
    end

    subgraph "第二部分：一次请求的旅程"
        CH03[Ch03 请求旅程]
        CH04[Ch04 AIAgent 内核]
        CH05[Ch05 提示词系统]
    end

    subgraph "第三部分：能力层"
        CH06[Ch06 工具系统]
        CH07[Ch07 工具剖面]
        CH08[Ch08 技能系统]
        CH09[Ch09 子代理委托]
    end

    subgraph "第四部分：状态与记忆"
        CH10[Ch10 SessionDB]
        CH11[Ch11 Memory Provider]
        CH12[Ch12 上下文压缩]
    end

    subgraph "第五部分：多平台"
        CH13[Ch13 CLI/TUI]
        CH14[Ch14 Gateway]
        CH15[Ch15 定时调度]
        CH16[Ch16 执行环境]
    end

    subgraph "第六部分：工程基础"
        CH17[Ch17 配置系统]
        CH18[Ch18 模型抽象]
        CH19[Ch19 并发模型]
        CH20[Ch20 进程生命周期]
        CH21[Ch21 运行时容错]
        CH22[Ch22 测试体系]
    end

    subgraph "第七部分：收束"
        CH23[Ch23 设计哲学]
    end

    CH02 --> CH03
    CH03 --> CH04
    CH04 --> CH05
    CH04 --> CH06
    CH06 --> CH07
    CH06 --> CH08
    CH04 --> CH09
    CH04 --> CH10
    CH10 --> CH11
    CH11 --> CH12
    CH04 --> CH13
    CH04 --> CH14
    CH14 --> CH15
    CH07 --> CH16
    CH04 --> CH19
    CH14 --> CH20
    CH20 --> CH21
    CH01 --> CH23

    style CH04 fill:#f96,stroke:#333,stroke-width:3px
    style CH08 fill:#9cf,stroke:#333,stroke-width:2px
    style CH11 fill:#9cf,stroke:#333,stroke-width:2px
    style CH20 fill:#fc9,stroke:#333,stroke-width:2px

图中高亮节点：Ch04 AIAgent 内核（橙色）是全书枢纽，几乎所有章节依赖它；Ch08 技能系统和 Ch11 Memory Provider（蓝色）是 Hermes 差异化的核心；Ch20 进程生命周期（黄色）是稳定性的基石。

阅读标记说明

源码引用：使用 文件名:行号 格式，如 run_agent.py:416 表示 run_agent.py 文件第 416 行
流程图：使用 Mermaid 格式，可在 mdbook 中直接渲染
设计赌注回扣：每章结尾会标注本章回扣了哪个设计赌注
跨章引用：使用"详见第 N 章"格式

关于代码版本

本书分析基于 Hermes Agent v0.8.0（2026 年 4 月）。Hermes 是一个活跃开发的项目，源码可能在你阅读时已有变化。每章末尾的"版本演化说明"会标注分析基准版本和已知变化。

致谢

感谢 Nous Research 团队将 Hermes Agent 开源，让我们有机会深入学习一个生产级 AI agent 的工程实践。

Hermes Agent 源码与设计

前言