模式索引

阅读契约： 把本页当作决策清单。先从你要解决的问题出发，再跳回解释该 pattern 和 failure mode 的章节。

这一页汇总全书反复出现的可迁移设计模式。它们不是 Codex 独有技巧，而是任何能检查文件、运行命令、调用外部工具或服务多种客户端的 LLM 产品都要面对的架构动作。

模式列表

先读 enum 和 struct，再读长函数。`Op`、`Submission`、`Event` 和 app-server requests 会先暴露产品契约。

客户端提交 operation，同时监听 events。TUI、exec 和 app-server 因此可以共享一个 core runtime。

一次 turn 聚合上下文、模型采样、工具、hooks、compaction 和完成条件。

工具不是函数指针。它携带 schema、可变性、hooks、取消、输出格式和用户可见效果。

结构化补丁让编辑可审查、可审批、可生成 diff，也更容易归因到某次 turn。

approval policy、permission hooks、Guardian review 和网络策略 amendment 位于单个工具之上。

Codex 把沙箱看成对执行请求的变换，由平台、策略、权限和 retry 语义共同决定。

Skills、plugins、app mentions 和 MCP inventory 变成 turn-scoped context 和 tools，而不是散落的特殊循环。

TUI 和 app-server 的呈现方式不同，但都消费同一个 session model 产生的结构化 events。

模式必须贴住证据才有价值。每个模式对应的章节都提供证据表、固定到公开 commit 的源码链接、面向初学者的解释和一个阅读练习。想一次性回到源码，请看源码索引。