本系列的 Pi、Codex 与 DeepSeek Harness 引用固定到审阅 commit;Claude Code 2.1.88 只保留 source-map 恢复快照中的非点击式源码坐标,博客不托管其恢复源码或原生二进制。

覆盖 Pi Agent Harness、OpenAI Codex、DeepSeek Harness、Anthropic Claude Code。分析快照:2026-08-29。

最重要的结论

这四个 Agent 的真实差别是控制权放在哪里,不是内置工具数量:

  • Pi:把控制权交给用户扩展和多 provider 抽象。当前生产主链小而清晰,但没有内置 permission popup、OS sandbox、MCP 或核心 subagent scheduler;仓库里的 durable harness/server 尚未完整接替生产 CLI。
  • Codex:把控制权放在 app-server、Session submission、exact step context、tool registry、安全 orchestrator、ThreadStore 与 multi-agent control plane,系统边界最显式。
  • DeepSeek Harness:把控制权放在 Cordis profile/effect composition 与 durable event surface;loop 很薄,Web/headless/ACP 主要是不同插件装配。
  • Claude Code:在可审计的 2.1.88 中,把控制权集中在共享 async-generator query(),再叠加成熟权限、压缩、AgentTool、Skills/Plugins/MCP 与 UI;最新版 2.1.251 已原生二进制化,内部实现不能从 npm wrapper 静态验证。

Coding Agent 源码解析导读:版本、证据与四种控制面 · 架构图 1

阅读顺序

  1. 先读本文后半部分的“源码清单、新鲜度与证据等级”,理解每个结论能证明到哪个版本。
  2. 四个 Agent 功能总矩阵——快速建立全局差异。
  3. 按仓库深入:
  4. 按功能横切:
  5. 2025–2026 国内大厂 Agent 面经——把源码机制映射到真实面试题、公司画像和 14 天准备计划。

交互式代码地图

每份 HTML 都是 self-contained,可在浏览器中独立打开;发布前已逐一验证主要功能页、文件浏览和 light/dark 主题。地图只包含结构统计、模块关系和符号名称,不包含恢复源码正文。

Agent地图结构焦点功能页
Pi打开地图生产 CLI 与 durable/server 双线Runtime surfaces、Integration、Providers
Codex打开地图app-server/core/store/security cratesExecution spine、Security、Interfaces
DeepSeek Harness打开地图Cordis 与 package familiesComposition、Session surface、Package families
Claude Code 2.1.88打开地图query 支撑目录与产品子系统Query loop、Tools & safety、Extensions

如何解释比较结果

  • 核心内置、扩展实现、实验性、类型契约存在是四种不同成熟度。
  • Permission 决定“是否允许”,sandbox 决定“允许后实际能触达什么”。
  • Transcript 文件存在不等于 model context 可重放;要看 surface 重建与 compaction boundary。
  • “支持 subagent”不等于有共享控制面;子进程示例、provider seam、AgentTool 与 root-tree scheduler 不能互换。
  • 源码能解释机制,不能直接推出模型完成率、延迟、成本或 benchmark 排名。

证据质量

每份单仓与功能文档都包含:关键源码、结论先行、架构/时序图、核心概念、逐段 path:Lx-Ly 证据、系列导航、活跃开发方向和 [待调查]。自动 analyzer 用于生成文件、语言和 AST 统计;关键结论均经人工调用链与固定源码坐标复核。

尚未做的事情

  • 没有用同一模型与同一 benchmark 比较效果。
  • 没有用真实 provider key 跑端到端任务。
  • 没有对所有平台 sandbox 做动态逃逸测试。
  • 没有把 Claude Code 2.1.88 的实现外推为 2.1.251。

这些限制是刻意保留的证据边界,而不是用推测补齐。


源码清单、新鲜度与证据等级

快照日期:2026-08-29(Asia/Shanghai)。本页回答“分析的是哪个仓库、哪个 commit/package、能证明什么”。

结论先行

Pi、Codex、DeepSeek Harness 的官方 Git 仓库已经 fast-forward 到各自远端最新分支且保持 clean。Claude Code 的最新版已下载为官方 npm wrapper 与 macOS arm64 原生二进制,但最新版不再携带可读实现源码;详细静态分析采用经 source map 字节级验证的官方 npm 2.1.88 发布源码。第三方 Claude Code 重建只保留作交叉参考,不进入事实证据链。

Coding Agent 源码解析导读:版本、证据与四种控制面 · 架构图 2

版本表

Agent官方来源审阅工件分支/版本分析 commit/工件新鲜度结论
Piearendil-works/piearendil-works/pi@853a80dmain, npm package 0.84.4853a80d26c90a14c1886f0ebb8ffaae133ca2185已 fast-forward 到 origin/main;manifest 版本与 registry latest 一致
OpenAI Codexopenai/codexopenai/codex@6478a751main; npm latest 0.150.16478a751fde8884b2fdc76486fe23175a8e795d4已 fast-forward 到 origin/main;源码 manifest 使用 0.0.0-dev
DeepSeek Harnessdeepseek-ai/deepseek-harnessdeepseek-ai/deepseek-harness@cd5ef814master, repo 0.1.2-alpha.1cd5ef8148158c3a752a658978873241fdf8e2bbc已 fast-forward 到 origin/master;仓库 HEAD 新于 registry latest RC 0.1.1-rc.2
Claude Code(详细实现)official npm artifactClaude Code 2.1.88 官方 npm 工件 + Claude Code 2.1.88 source-map 恢复快照2.1.88cli.js + cli.js.map; recovery repo 2ca5ddab…source-map 精确恢复发布 artifact,非最新版
Claude Code(最新版校准)@anthropic-ai/claude-codeClaude Code 2.1.251 官方 npm 工件2.1.251wrapper + sdk-tools.d.ts最新 package,可验证包装/类型契约,不能验证内部实现
Claude Code native@anthropic-ai/claude-code-darwin-arm64Claude Code 2.1.251 官方原生发布物2.1.251197,171,680-byte Mach-O arm64最新可执行发布物,只适合黑盒/符号分析

Pi CLI manifest 明确给出 @earendil-works/pi-coding-agent@0.84.4 以及 binary/export surface。packages/coding-agent/package.json:L1-L25 Codex 的源码 npm wrapper 刻意使用 0.0.0-dev,因此不能用 repository manifest 推断公开 registry version。codex-cli/package.json:L1-L20 DSH root manifest 为 0.1.2-alpha.1 并列出 workspace 与 Node/pnpm 要求。package.json:L1-L18

Claude Code 的特殊证据链

1. 为什么没有“更新泄露仓库后直接分析”

本地 Claude Code 2.1.88 source-map 恢复快照 的 origin 曾指向 sanbuphy/claude-code-source-code,但远端现在已重命名/改造成不同项目。直接 git pull 会把一份仍有研究价值的 2.1.88 恢复快照混入无关历史,所以保留原工作树,只更新了另一份第三方重建 Claude Code 第三方重建快照。后者不是 Anthropic 官方源码,本文不把其实现当证据。

2. 2.1.88 source map 校验

恢复包自己声明版本 2.1.88。package.json:L1-L6 校验脚本 verify_claude_sourcemap.mjs 读取官方 cli.js.map,只选择 ../src/ application sources,把 sourcesContent 与恢复树逐字节比较。结果:

项目值
source map 总 entries4,756
../src/ application entries1,902
精确一致1,902
缺失0
内容不一致0
cli.js.map SHA-2567965012b7a5fc9e09d8d747a04c5c32b94696924536e217f686bb1e7ee70a657
cli.js SHA-25675c9611929d9a770fe2e3a393219d8b98f5de17fde539b2a7355c6db3fd2795f

该结果证明恢复树与 2.1.88 发布 bundle 中保留的应用源码一致。它不覆盖 dead-code-eliminated feature modules,也不允许外推到 2.1.251。

校验脚本在本地研究工作区执行;本系列公布校验方法、统计与哈希,但不托管 Claude Code 恢复源码或原生二进制。

3. 2.1.251 最新发布物

最新版 wrapper 声明 2.1.251、Node 22+ 与八个平台 optional packages。2.1.251/package.json:L1-L38 安装脚本选择平台包并用硬链接/复制放置原生 CLI。2.1.251/install.cjs:L99-L139

发布工件SHA-256
anthropic-ai-claude-code-2.1.251.tgz44d28caf1711767c14a0388db56b13f49dbd8d3e1db635dd98aa3115c760cf27
anthropic-ai-claude-code-darwin-arm64-2.1.251.tgzcb3ecffa649ea20b78f3b7fe4a7395d7a225a510ae18521f6b65c669ecf4d9fd
unpacked native claude625869b01e0050f260b2980fac248fd9cef9e462612bded4ec9d3d49ff8969a5

sdk-tools.d.ts 可用于确认公开 type union 和字段,但类型存在不代表普通 CLI profile 启用对应工具。sdk-tools.d.ts:L8-L102

静态分析报告

codebase-onboarding-skill 的 analyzer 生成了本地机器可读报告;博客只发布复核后的结论与汇总统计,避免把含本机路径的中间工件公开。

Analyzer 使用 workspace-local tree-sitter grammar cache。LOC 是文件换行数近似值,因为环境中缺少 tokei/scc;AST symbol count 可用,但如果 JSON 的 warnings 中出现 PageRank 错误,就不能把 key_entities 当成成功排序结果。最终架构结论均由人工调用链与行号复核,不由目录名或 PageRank 单独推断。

本次最终报告主动用 --skip-ranking 禁用了上游 reference-graph PageRank:该实现逐个文件扫描全部唯一符号,复杂度近似 files × symbols,在这些大仓库上没有合理上界。它不是分析缺失;文件、语言、manifest、framework、tree-sitter AST symbols 与 Git insights 都成功完成,且 warnings 为空。

报告发现文件AST symbolsPageRank
Pi1,0623,941主动跳过
Codex4,24047,999主动跳过
DeepSeek Harness5,11111,795主动跳过
Claude Code source-map 2.1.881,93211,580主动跳过
Claude Code 第三方重建2,84613,150主动跳过

系列导航

活跃开发方向

  • 为 Claude Code 2.1.251 获取官方 source map/符号化工件,缩小版本证据差距。
  • 将每次 registry/package/version 查询固化为机器可读快照。
  • 在不需要凭据的路径上做 --help、initialize/schema 和 transcript 黑盒差分。
  • 为 analyzer 增加可靠的 Rust/TS 大仓库增量缓存与 LOC backend。

待调查问题

  • [待调查] Claude Code 2.1.251 内部调用链与 2.1.88 的差异。
  • [待调查] 被 2.1.88 DCE 的内部模块是否存在可公开验证的 source artifact。
  • [待调查] npm registry version 与 Git main 的发布映射在 Pi/DSH 上是否有明确 tag/commit provenance。
  • [待调查] 静态恢复与公开 license/redistribution 边界需要使用者自行按原项目条款审查;原恢复快照仅用于研究分析,本博客不分发相关源码或发布物。
  • [待调查] 如确需 symbol importance,应以 import/call AST 建边或倒排索引替代当前 files × symbols 正则扫描,再单独验证排名质量。