配套技术报告的源码级解析文档，每章均含"本章导读→分节精讲→设计原理剖析→小结"结构，关键结论附真实源码路径。
| 你想搞懂… | 阅读章节 |
|---|---|
| 智能体主循环怎么转 | 07 → 08 → 09 → 10 → 11 |
| 长任务记忆怎么不丢 | 13 → 14 → 15 → 16 → 17 → 18 → 19（核心） |
| 自主与安全怎么平衡 | 20 → 24 → 27 → 30 → 32 |
| 多智能体怎么协作 | 33 → 34 |
| 如何嵌入自己的产品 | 35 → 36 → 39 |
| 我想自己造一个 Agent Harness | 01 → 03 → 08 → 13 → 20 → 27 → 35 |
本地优先的编码智能体定位、Rust+TS 混合架构、运行模式与同类产品对比。
Ch02137 个 crate 的四层组织（接口/核心/基础/扩展），依赖单向化避免"大泥球"。
Ch03从 Node.js 包装层到 Rust 主进程；arg0 分派实现"一进程多角色"。
Ch04四级配置层级（组织>用户>项目>会话）、profiles、类型安全枚举。
Ch05ModelProvider trait 模型无关设计、Responses API、SSE 流式传输。
Ch06Feature Flag 五阶段生命周期、Extension API、快速迭代与稳定控制的平衡。
CodexThread/Session/ThreadManager 三层架构；不可变配置快照保证并发安全。
Ch08全书最重要的一章：run_turn 六态状态机（PreTurn→Compacting→ContextBuilding→Sampling→ToolExecution→Complete）。
Ch09WebSocket/HTTP 双传输、增量事件模型、重试策略与 sticky routing。
Ch10EventMsg/ThreadEvent 事件模型、broadcast channel 多订阅者、背压缓冲。
Ch11input_queue 插队、AgentControl 控制面、中断传播——长任务的"逃生舱"。
Ch12StateService、thread-store 的 Store trait 抽象、SQLite 元数据。
ContextManager 架构：上下文的建模、组装、更新与 token 预算追踪。
Ch14ResponseItem 历史、窗口内条目增删改、输出余量计算。
Ch15token 阈值触发、摘要提示词、压缩后历史重建、模型降级回退。
Ch16v1→v2 协议演进、服务端压缩流程、与本地压缩的差异与回退关系。
Ch17JSONL 逐事件落盘、文件压缩、resume 重放原理——断点续跑的基石。
Ch18环境信息/git 状态/时间等前缀材料、fragment 片段化按需注入。
Ch19分层系统提示词、memories 持久化注入、AGENTS.md 发现与合并规则。
registry/router/orchestrator 骨架、工具 schema 暴露、并行调用调度。
Ch21命令规范化、unified_exec、超时与输出截断、跨平台差异。
Ch22补丁格式与解析器、流式应用、失败回退到 view/edit 流程。
Ch23file-search 双线程架构（walker+nucleo）、limit=20 截断防上下文爆炸。
Ch24三层优先级 Hooks→Guardian→User；"只缓存批准、不缓存拒绝"。
Ch25SKILL.md 四级作用域、显式/隐式调用、技能=工作流知识封装。
Ch26外部 MCP 工具统一收编、Hook 三拦截点、暴露策略四档。
"沙箱内自由，沙箱外审批"；SandboxMode×ApprovalPolicy 组合矩阵。
Ch28Landlock LSM、seccomp、命名空间、bwrap 集成。
Ch29Seatbelt SBPL 声明式策略 vs Restricted Token+Job Object+ACL。
Ch30Starlark 声明式规则、命令执行前静态分析、"批准一次，学习一次"。
Ch31UDS 客户端-服务器提权架构、pre-main 阶段加固、最小权限原则。
Ch32Guardian 子智能体独立审查、失败关闭原则、断路器防死循环。
agent registry/resolver、内置代理体系、与主代理的关系。
Ch34interactive/one-shot 双模式委派、Spawn/Message/Followup/Result 协议、Ed25519 代理身份。
Ch3520+ JSON-RPC 方法、10 层优先级配置覆盖、IDE 集成。
Ch36Codex 作为 MCP server：stdio 传输、双向 MCP 生态、暴露面三重约束。
Ch37codex exec 无头模式、exec-server、cloud-tasks 云端编排。
Ch38app 事件循环、chatwidget 订阅核心事件流、斜杠命令与审批界面。
Ch39TypeScript/Python SDK、VS Code 扩展、外部智能体迁移、code-mode。