《读懂 Codex》PDF 版：完整参考版与主干学习版

《读懂 Codex：从大模型到智能编程助手》已经整理为 PDF。这不是把网页简单拼接后导出的附件，而是一套面向长期阅读的固定版本：章节顺序以全书目录为准，技术图直接嵌入文件，代码、表格和跨页规则也针对纸面阅读重新处理。

这次提供两个版本。第一次阅读建议从主干学习版开始；遇到需要继续追踪的实现细节，再打开完整参考版。

版本	内容	页数	大小
主干学习版 PDF（R4）	十章主线内容，用于建立 Codex 的整体知识框架	99	1.6 MB
完整参考版 PDF（R4）	全书 10 章、295 篇正文及 591 幅嵌入式技术图	1552	21.1 MB

R4 修订内容

• 十章总览和 285 个细节单元全部完成第一轮逐段润色。正文直接陈述定义、状态所有者、执行顺序、不变量和失败边界，不再用“上一节／下一章／旧稿／读者”组织内容。
• 十章章内索引逐项覆盖 285 个细节单元。第六章 82 项工具与沙箱索引、第七章 40 项协作与扩展索引、第八章 34 项持久化索引均已与实际文件核对。
• 删除第七章 40 段重复结论和第八章 30 组模板前言、重复图注与流程复述；修正 Spawn 被误写成原子回滚事务的问题，明确身份提交后的失败残留。
• 修复 4 个指向旧文件名的章节导航。全书 2677 个本地章节与图片引用无缺失，跨文件重复长段和正文章节串场扫描均为 0。
• 完整版 580 个内部跳转和 309 个书签全部指向有效物理页；591 张 SVG 以矢量内容直接嵌入 PDF，file: 链接和空白内容页均为 0。

两个版本怎样使用

主干学习版沿着一条连续路径展开：语言模型怎样获得行动能力，一次任务怎样进入 Codex，Thread、Turn 与 Step 如何组织执行，上下文和事件怎样流动，工具与沙箱如何控制副作用，多 Agent、持久化与恢复怎样工作，最后再用 Mini Codex 反向验证这些设计。

完整参考版保留了各章下面的专题细节。它更接近一本实现参考书，不要求从第一页连续读到最后一页。阅读主干内容后，可以根据问题回到对应章节，例如查找审批策略、命令执行、上下文压缩、MCP、多 Agent 协作或会话恢复的完整说明。

建议按下面的顺序使用：

1. 通读 99 页主干学习版，在目录或笔记中标出尚未理解的概念。
2. 用完整参考版查阅相应专题，同时对照代码、协议或运行日志验证结论。
3. 完成第九章的 Mini Codex，实现最小模型调用、工具循环、事件流和持久化路径。
4. 后续版本更新时保留旧 PDF，按文件日期区分版本，不让新内容覆盖原来的学习记录。

版本与完整性

本版为 2026 年 8 月 4 日 R4 修订版。公开文件的校验值如下：

3d181164b219123aba43a7c3d6ff1f48b9a4d3e7689123d18e80ed71f2d8a277  codex-research-full-2026-08-04-r4.pdf
2cc2ffbb607143097148628e8898fa121f44a297ebfcd5e6de05783e56f3f23f  codex-research-core-study-2026-08-04-r4.pdf

下载后可以运行 sha256sum 文件名，将输出与上面的值比较。页数、字节数、内容指纹和构建来源记录在 公开清单 中。

初版文件继续保留，已有链接和学习笔记不会失效。这仍然是一份持续修订的研究文档；后续内容批次使用新的修订文件名，不覆盖已发布版本。