第 1 章研究笔记

关键证据

• README.md 明确说明本仓库是基于 npm 发布包和 source map 分析还原的非官方研究仓库，版本是 2.1.88。
• extract-sources.js 从 package/cli.js.map 的 sourcesContent 字段写出 restored-src/。
• package/package.json 只描述发布包，入口是 cli.js，没有源码构建脚本。
• package/cli.js 是已经打包好的可运行产物。
• restored-src/src/main.tsx 是还原出的源码入口，但仓库缺少官方构建配置、路径别名、私有依赖和 bun:bundle 构建时模块。

结论

这个仓库适合做架构阅读，不适合直接二次开发成官方等价产物。

读者应该重点学习：

• Agent CLI 如何启动。
• Agent 主循环如何组织。
• Tool 系统如何设计。
• 权限、Hooks、会话、上下文压缩和扩展机制如何工程化。

读者不应该把重点放在：

• 还原官方构建链。
• 复刻所有 feature flag。
• 复刻完整终端 UI。
• 依赖私有 @ant/* 包。