前言

本书以 xAI 开源的终端 AI 编程代理 Grok Build（Rust，75 个 crate）为主轴，以 openai/codex 与 sst/opencode 为参照系，剖析构建一个生产级 AI 编程代理的完整设计空间：从 agentic 循环、上下文压缩、工具系统、沙箱隔离，到终端增量渲染与扩展生态。

主线是"一个 agent 的一生"：键入 prompt → 采样 → 工具执行 → 渲染 → 持久化。每章末附"同一问题，codex 怎么做"参照小节。

阅读准备

前置知识

Rust：能读懂 trait、async/await、所有权相关代码即可，不要求写过大型项目
终端基础：知道 ANSI 转义码、TTY 的概念
不需要：LLM 训练/推理知识、ratatui 使用经验

事实纪律

本书所有架构性陈述均带 file:line 引用，基于书末"版本演化说明"标注的仓库快照。引用有效性由自动化工具持续校验；上游代码更新后失效的引用会在修订版中更新。

一条更重要的纪律：以实现为准，注释仅为线索。源码里的文档注释会因代码演化而过时甚至失真（第 18 章有一个"注释宣称 mmap 零拷贝、实为 fs::read"的真实样本）。每一处 file:line 引用，都意味着作者去那一行读了实际的代码，而非誊抄注释。

全书知识地图

flowchart TD
    subgraph p1["第一部 · 全景"]
        c1["1 时代与是什么"] --> c2["2 75 crate 工程哲学"]
    end
    subgraph p2["第二部 · 代理运行时"]
        c3["3 Actor 会话引擎"] --> c4["4 agentic 循环"]
        c4 --> c5["5 上下文压缩"] --> c6["6 持久化"]
        c3 --> c7["7 leader-follower"]
    end
    subgraph p3["第三部 · 工具系统"]
        c8["8 两层工具抽象"] --> c9["9 文件编辑"]
        c8 --> c10["10 checkpoint/worktree"]
        c8 --> c11["11 沙箱"]
        c8 --> c12["12 拿来主义归一层"]
    end
    subgraph p4["第四部 · TUI"]
        c13["13 事件循环"] --> c14["14 增量渲染"]
        c14 --> c15["15 流式 Markdown"]
        c13 --> c16["16 终端工程学"]
    end
    subgraph p5["第五部 · 扩展与治理"]
        c17["17 MCP/Hooks/插件"]
        c18["18 治理与记忆"]
    end
    p1 --> p2 --> p3 --> p4 --> p5
    c4 -.采样/工具.-> c8
    c3 -.ACP 消息面.-> c13

锚点章：**第 3 章（Actor 会话引擎）**是全书的结构枢纽——运行时、工具、TUI 三条线都从它辐射。若时间有限只读一章，读它。

阅读标记说明

> **定位**（每章开头）：一句话核心主题 + 前置依赖 + 适用场景，帮你 30 秒判断这章此刻是否与你相关。
设计要点回顾（每章结尾）：把该章所有关键结论连同 file:line 索引成一页，便于回查与速览。
版本演化说明（每章结尾）：声明该章分析所据的版本基准（发布 commit c68e39f / SOURCE_REV 2ec0f0c…），供你判断内容是否仍然适用。
同一问题，codex 怎么做（多数章内）：把 Grok Build 的决策与 openai/codex 的对应实现并置，照出"品类共性 vs 团队选择"的分野。
crates/...:行号 形式的引用：指向仓库里的真实代码，鼓励你亲自核对。

AI Coding Agent 架构解剖：从 Grok Build 源码看终端智能体的设计与实现

前言

阅读准备

前置知识

事实纪律

推荐阅读路径

全书知识地图

阅读标记说明