Codex 架构解析

章节：案例研究第18章第2节
难度：⭐⭐⭐⭐ 专家级
阅读时间：30-35 分钟
核心收获：深入理解 Codex 的技术架构和设计哲学

21.7 理论要点：从 Agent Loop 到 Durable Workspace

21.7.1 核心转变

从"对话"到"工作空间"： - 传统：每次新开对话，上下文丢失 - Codex：持久线程，状态持续积累

从"单次响应"到"持续工作"： - 传统：输入 → 输出，完成 - Codex：目标 → 分解 → 执行 → 验证 → 持续迭代

21.7.2 架构层次

┌─────────────────────────────────────────┐
│              用户界面层                   │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐    │
│  │ CLI     │ │ IDE插件 │ │ Web应用 │    │
│  └─────────┘ └─────────┘ └─────────┘    │
├─────────────────────────────────────────┤
│              智能体层                     │
│  ┌─────────────────────────────────┐    │
│  │         Agent Loop              │    │
│  │  ┌─────┐  ┌─────┐  ┌─────┐    │    │
│  │  │推理 │→│工具 │→│观察 │→...│    │    │
│  │  └─────┘  └─────┘  └─────┘    │    │
│  └─────────────────────────────────┘    │
├─────────────────────────────────────────┤
│              工具层                       │
│  ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐        │
│  │Shell │ │文件 │ │搜索 │ │MCP  │        │
│  └─────┘ └─────┘ └─────┘ └─────┘        │
├─────────────────────────────────────────┤
│              模型层                       │
│  ┌─────┐ ┌─────┐ ┌─────┐                │
│  │Opus │ │Sonet│ │Haiku│                │
│  └─────┘ └─────┘ └─────┘                │
└─────────────────────────────────────────┘

21.8 核心机制解析

21.8.1 Durable Thread（持久线程）

实现： - 会话状态持久化到数据库 - 上下文跨会话保持 - 自动摘要和压缩

数据结构：

{
  "thread_id": "uuid",
  "created_at": "2026-07-10T09:00:00+08:00",
  "updated_at": "2026-07-10T17:00:00+08:00",
  "context": {
    "project": "ai-hotspot",
    "preferences": {...},
    "history": [...]
  },
  "state": "active",
  "metadata": {
    "model": "gpt-5.5",
    "total_tokens": 50000
  }
}

21.8.2 Agent Loop（智能体循环）

用户输入
  ↓
构建 Prompt（系统 + 开发 + 用户 + 工具）
  ↓
模型推理（Responses API）
  ↓
输出类型判断
  ├── 文本回复 → 结束
  └── 工具调用 → 执行工具 → 附加结果 → 回到推理

21.8.3 并行 Agent（Fan-out）

主任务
  ↓
分解为子任务
  ↓
并行启动多个 Agent
  ├── Agent 1：功能开发
  ├── Agent 2：测试编写
  ├── Agent 3：文档生成
  └── Agent 4：安全审计
  ↓
各 Agent 在独立 git worktree 工作
  ↓
汇总结果，合并到主分支

21.9 图文说明

📌 待补充：建议绘制以下示意图 1. 架构层次图 2. Agent Loop 流程图 3. 并行 Fan-out 示意图 4. 持久线程生命周期图

21.10 关键启示

📝 版本迭代记录