OpenCode Agent 源码学习
这是一个由 Codex agent 写作和维护的源码学习站点。每个 OpenCode 源码版本拥有独立正文、元数据和源码证据；默认展示最新版，历史教程不会被覆盖。
| 教程版本 | 源码提交 | 状态 |
|---|---|---|
| v1.18.16 | a3647eb025c7 | 默认 / 最新 |
| 旧版 eec0843c | eec0843ce422 | 历史归档 |
- 当前版本：
v1.18.16 - 源码基线：
a3647eb025c7615159d417dcc49fc39fdaeba65b - 规划章节：14
- 已完成章节：14
- 待补章节：无
- 最近质量检查：
v1.18.16-dual-version
| # | 章节 | 难度 | 预计阅读 | 状态 |
|---|---|---|---|---|
| 01 | CLI / 启动入口 | 入门 | 35 分钟 | 已完成 |
| 02 | 用户输入与会话 | 中等 | 40 分钟 | 已完成 |
| 03 | Agent 核心循环 | 较难 | 45 分钟 | 已完成 |
| 04 | 模型 Provider / LLM 调用 | 较难 | 50 分钟 | 已完成 |
| 05 | Tool 调用系统 | 中等 | 50 分钟 | 已完成 |
| 06 | 文件读写与代码修改 | 中等 | 40 分钟 | 已完成 |
| 07 | Shell / 命令执行 | 较难 | 45 分钟 | 已完成 |
| 08 | LSP / 诊断 / 上下文增强 | 较难 | 45 分钟 | 已完成 |
| 09 | 权限、审批、安全边界 | 中等 | 40 分钟 | 已完成 |
| 10 | 配置系统 | 较难 | 45 分钟 | 已完成 |
| 11 | UI / TUI / Desktop / IDE 相关 | 中等到较难 | 35 分钟 | 已完成 |
| 12 | SDK / API / 对外扩展点 | 中等 | 40 分钟 | 已完成 |
| 13 | 测试与工程化 | 入门 | 30 分钟 | 已完成 |
| 14 | 从 OpenCode 反推 mini coding agent | 中等 | 60 分钟 | 已完成 |
推荐学习路线
Section titled “推荐学习路线”01 CLI / 启动入口 -> 02 用户输入与会话 -> 13 测试与工程化 -> 14 mini agent
Agent 核心路线
Section titled “Agent 核心路线”02 用户输入与会话 -> 03 Agent 核心循环 -> 04 模型 Provider / LLM 调用 -> 09 权限、安全边界
Tool calling 路线
Section titled “Tool calling 路线”03 Agent 核心循环 -> 05 Tool 调用系统 -> 06 文件修改 -> 07 Shell -> 08 LSP / 诊断
Agent 入口
Section titled “Agent 入口”以后新增或改写章节时，优先阅读 Agent 写作规范；需要理解为什么选这个框架时，阅读 框架选择。