如果你是第一次系统阅读一个真实 AI Coding Agent 仓库，最常见的问题不是”内容不够”，而是”信息太多，不知道先读哪一篇”。
这一页只做一件事：给你一张可以直接执行的阅读路线图。
核心概念快速定位
如果你想快速找到特定主题，直接跳转到对应章节：
| 核心概念 | 主要章节 | 补充章节 | 说明 |
|---|---|---|---|
| 🔄 Agent Loop（执行循环） | 第2篇 §2.5 | 第4篇 | Agent 的核心执行流程：输入→思考→工具调用→观察→输出 |
| 🔧 Tool / Function Calling | 第3篇 | 第11篇 | 工具系统的注册、执行、权限控制 |
| 📋 Planning 与任务分解 | 第3篇 §3.5 | 第15篇 §15.3 | task 工具、子任务创建、多 Agent 协作 |
| 🧠 Memory 机制 | 第4篇 §4.3 | 第9篇 | 短期记忆（会话）、工作记忆（压缩）、长期记忆（持久化） |
| 💬 Prompt 与上下文管理 | 第2篇 §2.4 | 第4篇 | 系统提示词、上下文窗口、Token 预算 |
| 👥 多 Agent 协作 | 第15篇 §15.3 | 第2篇 §2.3 | primary/subagent 模式、权限继承、任务分发 |
💡 建议：如果你是初学者，不要直接跳到某个概念，先按下面的”推荐起点”顺序建立整体认知。
推荐起点
如果你是 Agent 开发初学者，默认按下面顺序读：
- 第一篇：先建立“系统怎样跑起来”的最小闭环
- 第二篇：再理解 Agent 是如何被定义和约束的
- 第三篇：再看工具怎样进入 Agent 能力边界
- 第四篇：最后把会话怎样把模型、工具和状态串起来读顺
读完这四篇后，再决定往哪条路线深入，效率会高很多。
全书统一主链路
Runtime lifecycle
全书统一运行时主链路
阅读地图不是另一套解释，它只是把同一条运行时主链路拆成更适合初学者执行的章节顺序。
Prompt 输入
prompt用户提出任务，系统先把输入整理成可消费的消息。
入口通常从 CLI、TUI 或 HTTP 请求开始，先决定本轮任务到底要解决什么。
Agent / Session
推荐先读session会话装配 Agent、权限、系统提示词和当前上下文。
这里决定角色、模式、消息历史和是否需要继续恢复已有状态。
Tool dispatch
推荐先读tools模型拿到可用工具后，进入工具调用与结果回写循环。
工具不是附属物，而是运行时主链路里最容易扩张成本和风险的边界。
Provider / Model
推荐先读providerProvider 抽象把具体模型接进统一的流式执行接口。
这里处理模型解析、认证、参数绑定和多提供商差异。
File / Terminal / LSP
side-effects真正改变系统状态的地方发生在文件、终端和代码智能能力上。
这是工程边界，不是文案边界；一旦进入这里，就需要权限和恢复机制兜底。
Result / UI feedback
feedback结果被写回消息流，再反馈到 CLI、TUI、Web 或桌面界面。
这一步决定用户看到的是最终答案、流式事件，还是下一轮可恢复的状态。
四阶段课程分级
阶段 1：先建立全局认知
01 Agent 基础架构
02 Agent 核心系统
03 工具系统
04 会话管理
阶段 2：再进入运行时主链路
05 多模型支持
06 MCP 协议集成
08 HTTP API 服务器
09 数据持久化
阶段 3：再理解交互与扩展
07 TUI 终端界面
10 多端 UI 开发
11 代码智能
12 插件与扩展
阶段 4：最后看工程化闭环
13 部署与基础设施
14 测试与质量保证
15 高级主题与最佳实践三条阅读路线
路线 A：从零入门 Agent 实现
适合：
- 第一次系统学习 Agent 开发
- 还没有搭过完整的工具调用和会话系统
- 希望先建立整体认知，而不是先啃某个细节模块
建议顺序：
这条线的目标，是先看懂“一个 Agent 系统怎样跑起来”。
路线 B：从运行时到产品化
适合：
- 已经理解基本 Agent 概念
- 更想知道多模型、协议、持久化、云端产品边界怎么落地
- 关心“真实项目为什么会长成现在这个架构”
建议顺序：
这条线的目标，是看懂“从本地运行时到产品级系统”的演进路径。
路线 C：从交互界面到扩展生态
适合：
- 对 TUI、Web、Desktop、IDE 集成更感兴趣
- 想理解代码智能和插件/Skill 体系
- 更关心“用户怎么和 Agent 协作”
建议顺序：
这条线的目标，是看懂“交互层和扩展层怎样让 Agent 真正可用”。
章节依赖关系
如果你只想知道“某一篇之前至少该看什么”，可以按下面这张简化依赖图走：
01 -> 02 -> 03 -> 04
04 -> 05 -> 06
04 + 07 -> 08
04 + 08 -> 09
07 + 08 + 09 -> 10
03 -> 11
03 + 06 -> 12
01 + 08 + 10 -> 13
03 + 08 + 10 -> 14
02 + 03 + 04 + 14 -> 15如果你时间有限
只读 4 篇
读这四篇：
这四篇足够帮你建立一个真实 Agent 系统的主骨架。
只读 8 篇
在前四篇基础上，加上：
这 8 篇足够让你看懂 OpenCode 的核心运行时闭环。
最后建议
不要试图一次性记住所有目录和所有文件。
更有效的方式是：
- 先按这张地图选一条线
- 每篇只抓“入口文件 + 主链路 + 最容易误解的点”
- 看完一篇，再决定要不要继续深入代码细节
如果你已经准备好了，建议从 第一篇：Agent 基础架构 开始。