用图、可读的文字和可核对的开源实现，理解 Agent 怎样决定下一步、调用工具、管理上下文与记忆，以及在权限和失败边界下完成任务。
这是一部持续写作的预览版指南，不是某个 Agent 项目的说明书。机制是主线，项目是有版本边界的案例，横向对照解释不同实现的取舍。 在线阅读站和PDF 电子校样可公开阅读；本仓库提供可核对的源稿与可编辑图。静态源码阅读不等于运行验证，也不代表已完成整本书的外部试读或正式出版。
| 想了解什么 | 阅读入口 |
|---|---|
| 我是初学者，先读什么、练什么？ | 四层渐进学习路线与项目推荐 |
| Agent loop、工具、上下文、记忆、权限与扩展怎样工作？ | 按机制学习 |
| 模型、Harness、CLI、Skill、MCP 到底各负责什么？ | 从一项任务看五层职责 |
| Pi、Codex、OpenCode、Letta 等开源系统怎样实现一条具体路径？ | 按开源系统阅读 |
| 同一问题为何有不同设计？ | 横向对照 |
| 先查术语，还是按书的顺序阅读？ | 术语表 · 阅读指南 |
第一次读可以从五层职责进入，再读 Agent loop，然后分别看 Pi 的循环与会话、Codex 的执行审批 或 Letta Code 的记忆可见性。这些图各回答一个问题，不合成一张虚构的“通用 Agent 内部架构图”。想按书逐章读，请打开完整书序目录；系统索引则适合按项目查找。
| 方式 | 用途 |
|---|---|
| 在线阅读网站 | 54 个正文单元及必要索引可公开阅读；可缩放、检索，是主要阅读入口。 |
| GitHub Markdown 书序目录 | 从卷首到卷末逐章阅读，查看可编辑图源、图的文字说明和固定源码链接。 |
| 可携带 Markdown 阅读包 | 从同一书稿清单生成 ZIP，解压后可在普通 Markdown 阅读器或 Obsidian 中打开；章节链接与图片保留相对路径。 |
| A4 PDF 电子校样 | 已人工发布公共链接版，供浏览或下载；不是定时自动发布的正式版本，也不是印刷母版。 |
所有阅读方式共享 Markdown 正文；书稿清单决定 GitHub 目录、网站、PDF 和阅读包的章节顺序，不维护第二份复制粘贴的书稿。写作与校稿方法说明一章怎样从问题、来源、图稿走到可合入的内容。
本轮候选包含 12 篇机制专题、14 个固定源码版本的系统局部剖面、6 篇跨系统对照和 25 组可编辑图。正文与 A4 PDF 电子校样虽已开放阅读，打印样张、运行实验、二次来源复核及外部读者验收仍待完成。PDF 不等于印刷母版，也不会随每周构建自动覆盖线上文件。当前状态与下一步是唯一进度入口；选题地图收录候选，但列入候选不等于已经核验。
每篇系统剖面应说明上游仓库与 commit、读到的源码或官方文档、结论适用范围，以及事实、推断和未知的区别。来源规则 · 图稿与导出规则 · 贡献指南
原创正文和图采用 CC BY 4.0，脚本与工作流采用 MIT。上游项目遵守各自许可；链接不表示它们为本书背书。公开预览、正式出版、许可终审与印刷验收是独立步骤，不由构建成功自动完成。
联系作者：ghr7719@gmail.com。读者可用网站反馈入口报告内容勘误并附可复现的源码证据；GitHub Issues 是否作为公共反馈入口由维护者另行决定。