flowchart LR
N0["01 版本与证据"]
N1["02 入口与循环"]
N2["03 工具与权限"]
N3["04 会话与上下文"]
N4["05 恢复与扩展"]
N5["06 横向对照"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5
现代Agent架构与源码研究
现代 Agent Engineering 学习路线：现代Agent架构与源码研究
0 子目录13 文档
CHAPTER OVERVIEW · 章节概览
先确认公开证据和版本范围，再跟踪循环、工具、会话及上下文；把已证实实现和推断分开记录。
本章学习路线
箭头表示建议的学习顺序；先理解问题，再逐步进入实现与实践。
按顺序学习
13Coding Agent 源码研究模板与证据等级读源码时，最容易把“看起来应该这样”写成“它一定这样”。这份记录方式把代码直接支持的事实、架构推断和未验证项分开。先固定版本，再沿调用关系找依据，读者才有机会重复你的检查。OpenAI Codex 源码精读：Agent Loop、工具、Skills、上下文与 Harness阅读 Codex 时，可以先跟着一个回合走：用户输入怎样进入 session，模型请求怎样形成，工具结果又怎样回到下一轮。把这条线看清，再展开 Skills、压缩和权限机制。下文的文件与符号是定位线索，不需要先背完整模块表。Anthropic Claude Code 精读：公开仓库、官方运行契约与 Agent HarnessClaude Code 的公开资料与完整产品内部实现不是一回事。本篇先解释公开可见的工作方式，再标明哪些结论来自仓库、文档或行为观察。阅读时保留这种区分，才不会把合理推断当作已经看过的源码。NousResearch Hermes Agent 源码精读：长运行、自改进 Agent HarnessHermes Agent 涉及模型适配、工具、技能和多种交互入口。可以先从一次对话如何进入循环开始，跟踪工具执行与结果返回，再看其余模块怎样加入。这样读比逐个目录浏览更容易形成整体认识。OpenClaw 源码精读：Gateway、Agent Harness、Tools、Memory 与 Context EngineOpenClaw 的入口、会话与运行时分工较多。先选一条消息，看它怎样经过 Gateway 到达对应会话，再跟到模型与工具。下文按固定快照解释这些连接，也把推断和未验证行为单独保留。Aider 源码研究：Repo Map、Edit Format 与 Git-aware 修复循环Aider 很适合用来观察“模型输出怎样真正变成代码改动”。阅读时先跟踪编辑格式的解析，再看文件修改、Git 和测试反馈如何连接。它与以通用工具调用为中心的系统不完全相同，这个差别贯穿全文。Goose 源码研究：Rust State Machine、MCP Extensions 与安全检查链Goose 的实现可以从一个 reply 的推进过程读起。先看操作怎样被选择和执行，再看审批、重试或压缩如何改变后续步骤。这样能把状态机中的名字对应到实际行为，而不是只记一串抽象类型。OpenCode 源码研究：Effect Runtime、Server/Client 与 Snapshot-aware Session LoopOpenCode 不只包含终端界面，界面背后还有会话服务、工具、权限和存储。可以先从一次会话请求进入，再观察不同层之间怎样传递事件。下面把交互入口与核心服务分开分析。DeepSeek Harness Web 源码研究：Cordis 插件树、事件日志与双端运行时这里关注 DeepSeek Harness 的 Web 版本。读它时先分清 Host 与浏览器两端分别运行什么，再看插件怎样注册服务与事件。沿着一次消息往返理解插件树，比把它想成一个巨大的 Agent 类更贴近代码组织。pi-agent 源码研究：极小 Loop、可组合 Harness 与树形 Sessionpi 的仓库里既有较小的 Agent Core，也有完整 Coding Agent 所需的工具和会话能力。建议先读核心循环，再看外层怎样补齐使用场景。下面沿着这种由内向外的顺序，避免把 UI 与核心决策混在一起。Grok Build 源码研究：Rust Agent Runtime、并行工具与 Worktree SubagentGrok Build 的研究重点是编码任务怎样被执行：消息进入后，模型怎样选动作，工具怎样修改环境，结果怎样返回。这里讨论的是 Coding Agent 工程，不是基础模型的训练或推理实现；两者需要不同的阅读线索。现代 Agent 架构与实现细节对比：十个 Coding Agent / Harness单看每个项目，工具、会话和上下文好像都差不多；放到同一个具体任务里，控制方式和修改文件的方法就会显出差异。下面用相同问题比较这些实现，不把功能表当作产品排名。现代主流 Coding Agent 研究阅读顺序如果是第一次读 Coding Agent 源码，先挑一个项目，追踪一次工具调用就够了。熟悉后，再比较上下文、权限和恢复机制。下面按阅读目的整理入口，各报告的结论都受所列源码快照与证据范围限制。