外观
附录 D · 官方文档与推荐资源
工具会迭代，一切最终以官方 V2 文档为准。本附录汇总权威入口与学习路径。注意：OpenCode 的 V1 与 V2 文档路径不同，请认准
/v2/。
D.1 权威入口
| 资源 | 链接 |
|---|---|
| 官方文档（V2） | https://opencode.ai/v2/docs/ |
| 文档索引（机器可读） | https://opencode.ai/v2/llms.txt |
| 配置 Schema（配置事实来源） | https://opencode.ai/config.json |
| GitHub 仓库 | https://github.com/anomalyco/opencode（以官方实际仓库地址为准） |
| GitHub Issues（报缺陷） | 仓库页面的 Issues 区 |
⚠️ https://opencode.ai/docs/（不带 /v2/）是 V1 文档，字段名与键位可能不同，本教程内容请勿以其为准。
D.2 本教程涉及的关键文档页
均位于 https://opencode.ai/v2/docs/ 之下：
| 主题 | 路径 |
|---|---|
| 配置 Config | /config/ |
| 从 V1 迁移 | /migrate-from-v1/ |
| 排障 Troubleshooting | /troubleshooting/ |
| Agents | /agents/ |
| Models | /models/ |
| Providers | /providers/ |
| Skills | /skills/ |
| Commands | /commands/ |
| Themes | /themes/ |
| Tools | /tools/ |
| MCP servers | /mcp-servers/ |
| Permissions | /permissions/ |
| Websearch | /websearch/ |
| Network（代理） | /network/ |
| Snapshots | /snapshots/ |
| Compaction | /compaction/ |
| Formatters | /formatters/ |
| Attachments | /attachments/ |
| Instructions（AGENTS.md） | /instructions/ |
| CLI 键位 | /cli/keybinds/ |
D.3 延伸学习建议
Prompt 工程基础（配合第 1 章）
- 围绕「清晰指令、提供上下文、给示例、迭代修正」的官方 Prompt 指南类文章；
- 练习方法：拿同一任务，分别写「差 Prompt / 好 Prompt」，对比结果差异——亲手对比胜过读十篇文章。
MCP 生态
- MCP 官方协议说明与官方服务器示例（了解本地 / 远程两类形态）；
- 接入纪律：只装真正需要的，并按
server_tool配权限（第 7 章）。
模型与供应商
- 各模型供应商官方文档（模型能力、上下文窗口、定价页）；
- 选型靠「按任务实测」，而不是只看排行榜（第 6 章）。
D.4 如何跟进版本变化
- 看 Release Notes / CHANGELOG：升级前快速浏览行为变更与键位调整；
- 以
llms.txt为索引：想确认某功能现状，先查它再定位具体页； - 配置以 schema 为准：字段是否存在、取值是否合法，
config.json永远最新； - 本教程的使用方式：先建立方法论与操作框架，细节在真实使用中以官方文档校准——框架不变，细节可查。
D.5 全书路线回顾
text
第 0 章 建立认知
第 1 章 Prompt 基本功（全书地基）
第 2 章 TUI 操作
第 3 章 上下文管理
第 4 章 AGENTS.md 规则
第 5 章 Agent / Command / Skill
第 6 章 模型与供应商
第 7 章 工具 / MCP / 联网
第 8 章 配置与个性化
第 9 章 Agent 工作流方法论
第 10 章 排障
附录 A–D 速查与资源最终建议：边用边学。带着真实任务打开 OpenCode，按章节顺序实践，把练习真正做一遍——能力来自使用与复盘，而不是收藏文档。祝你用得顺手。