附录 D：主题阅读导航

本附录按读者兴趣和常见问题，推荐章节组合。每条路径标注了核心章节（必读）和扩展章节（选读）。

按角色推荐

按主题推荐

"agent 怎么从经验中学习？"

Ch08 技能系统 — 技能的数据模型、生命周期、条件加载
  → Ch04 AIAgent 内核 — nudge 机制和 background review
  → Ch05 提示词系统 — SKILLS_GUIDANCE 如何引导模型创建技能
  → Ch11 Memory Provider — 记忆后端如何补充技能系统

"怎么让 agent 跑在远程服务器上？"

Ch16 终端后端 — 6 种执行环境（Local → Docker → SSH → Daytona → Singularity → Modal）
  → Ch14 Gateway — 通过消息平台远程控制 agent
  → Ch15 定时调度 — 无人值守的自动化任务
  → Ch20 进程生命周期 — systemd 服务和信号处理

"这个系统怎么处理长对话？"

Ch12 上下文压缩 — token 估算、保护区域、摘要替换
  → Ch04 AIAgent 内核 — IterationBudget 的压力预警
  → Ch05 提示词系统 — prompt cache 优化
  → Ch10 SessionDB — 会话持久化和跨会话搜索

"多平台适配怎么做到的？"

Ch14 Gateway — GatewayRunner + BasePlatformAdapter + SessionStore
  → Ch04 AIAgent 内核 — 11 个回调接口
  → Ch13 CLI/TUI — CLI 入口的回调实现对比
  → Ch21 运行时容错 — 断线重连和消息投递重试

"工具系统怎么设计的？"

Ch06 工具系统 — ToolRegistry + 自注册 + toolset 过滤
  → Ch07 工具剖面 — terminal、browser、delegate、mcp 四种典型工具的深度分析
  → Ch09 子代理委托 — delegate 工具如何创建子 AIAgent
  → Ch16 终端后端 — terminal 工具的 6 种后端实现

"怎么保证 agent 稳定运行？"

Ch20 进程生命周期 — 信号处理、Process Registry、清理守护线程
  → Ch21 运行时容错 — SafeWriter、API 重试、fallback、断线重连
  → Ch10 SessionDB — WAL 模式、jitter retry、事务管理
  → Ch19 并发模型 — async→sync 桥接、线程隔离、IterationBudget

"配置和多实例隔离怎么做？"

Ch17 配置系统 — config.yaml 解析、Profile 机制、环境变量覆盖
  → Ch18 模型抽象 — Provider 兼容层、模型能力探测
  → Ch02 仓库地图 — 了解配置影响的各层

"测试体系是什么样的？"

Ch22 测试体系 — 400+ 测试文件、conftest.py 隔离、分层测试策略
  → Ch02 仓库地图 — tests/ 目录结构与生产代码的镜像关系
  → Ch21 运行时容错 — 容错代码如何被测试

章节依赖关系速查

以下表格标注每章的前置依赖，帮助非顺序阅读时判断是否需要先读其他章节。

本导航基于 Hermes Agent v0.8.0 的全书结构。章节内容和依赖关系在后续版本中可能调整。