从零构建 AI Coding AgentOpenCode 源码剖析与实战

核心学习路径 ​

辅助阅读入口 ​

• 阅读地图：先选路线，再决定按哪条主链路进入全书。
• 版本说明：确认本书基于哪份源码、写到什么边界。
• 术语表：统一理解 Agent、Subagent、Primary Agent、运行时、工作台 等高频概念。
• 封版清单：查看当前版本完成度、已知非阻塞项和发布前检查项。

阅读边界：本书以当前 dev 分支源码实现为准，重点解释已经落在仓库里的结构、主链路和工程约束，不承诺覆盖未来版本变更。若文档与代码不一致，以当前仓库源码为准。

这本书怎么读 ​

• 如果你是第一次系统学习 Agent 开发，建议按 01 -> 02 -> 03 -> 04 先建立运行时主链路。
• 如果你更关心产品化落地，读完前四篇后优先看 05、06、08、09。
• 如果你更关心界面、IDE 集成和扩展生态，读完前四篇后优先看 07、10、11、12。
• 13、14、15 更适合放在最后，它们回答的是部署、质量与长期演进问题。

技术栈 ​

你会得到什么 ​

• 一张真实 AI Coding Agent 的系统总图，而不是零散功能点列表。
• 一套按“入口文件 -> 主链路 -> 关键边界”阅读大型源码仓库的方法。
• 对模型抽象、工具系统、会话系统、MCP、多端 UI 和扩展体系的工程直觉。
• 一组能迁移到自己项目里的设计原则，而不只是对 OpenCode 的局部记忆。

适合人群 ​

• 想要深入理解 AI Coding Agent 架构的开发者
• 希望学习大型 TypeScript 项目工程实践的工程师
• 对 AI 辅助开发工具感兴趣的技术爱好者
• 想要为 OpenCode 贡献代码的开源贡献者