封版清单

这一页不再讨论源码实现，而是把这本电子书当前的完成状态、已知非阻塞项和发布前建议检查项收成一张可执行清单。

当前状态

基于当前仓库与最近一轮系统整理，这本书已经具备较强的封版候选状态，但还要以“源码快照可信、主链路一致、练习模板可执行”为标准来收口：

• 首页、阅读地图、第一篇已经围绕统一运行时主链路重新组织。
• 站点已启用真实 lastUpdated 数据链，页级更新时间不再只是静态文案。
• version-notes 已定义全书统一源码快照语义。
• 全书 15 篇章节现已全部接入统一的源码快照卡。
• 全书 15 篇章节现已全部接入统一的 任务 / 操作 / 验收 练习模板。

已完成项

结构与导航

• [x] 首页已明确为“面向 Agent 开发初学者的 OpenCode 源码带读电子书”。
• [x] 阅读地图已升级为分阶段阅读入口，并与首页课程分级保持一致。
• [x] 全书 15 篇已全部接入侧边栏。
• [x] editLink 已指向本书仓库对应页面。

元信息与可信度

• [x] 已启用 VitePress git-backed lastUpdated。
• [x] version-notes 已说明全书源码基线与章节快照卡语义。
• [x] 首页与章节页已开始接入更稳定的页面级元信息。
• [x] 第一篇源码快照已改为 commit 锚定链接，而不是漂浮在 dev 分支上。

主链路与教学结构

• [x] 首页已接入全书统一运行时主链路图。
• [x] 阅读地图已用同一张主链路图解释章节顺序。
• [x] 第一篇开头已改成“先跑一次最小闭环，再看架构”。
• [x] LearningPath 已补充“这一阶段要看懂 / 看完后你应该能解释”。

章节模板

• [x] 各篇已统一 对应路径 / 前置阅读 / 学习目标 头部格式。
• [x] 各篇已统一 本章导读 主结构。
• [x] 全书 15 篇章节已补齐统一源码快照卡。
• [x] 全书 15 篇章节已补齐统一的 任务 / 操作 / 验收 练习模板。

仍需确认的收口项

章节一致性

• [x] 除 01 / 02 / 08 外，其余章节也已补齐统一源码快照卡。
• [ ] 第一篇站点版与父级草稿是否已经完全同步，无结构漂移。
• [ ] 各章源码链接是否都应该逐步切到 commit 锚定，而不是继续使用 dev 浮动链接。

构建与页面体验

• [x] 已再次执行 docs/book 下的 bun run build。
• [x] 已抽查 /01-agent-basics/index、/07-tui-interface/index、/12-plugins-extensions/index 的顶部快照卡与练习模板排版。
• [x] 已确认 最后更新于 显示真实时间，且 Pager 只存在于可访问性隐藏文本中，不是异常可见文本。

文案与术语

• [ ] 是否还有个别章节残留“讲义式模板语气”。
• [ ] 中英文引号、代码块、标题层级是否还有零星不一致。
• [ ] 术语表与章节正文对 Agent、Subagent、Primary Agent、运行时 的口径是否仍一致。

已知非阻塞项

当前没有确认会阻止发布的站点级故障，但仍有一类低风险漂移要留意：

• 章节内部仍有一部分 GitHub 链接使用 dev 分支，后续如果源码快速演化，解释与链接可能再次漂移。

如果现在就封版

如果你准备把当前版本视为第一版电子书，我建议按下面顺序收口：

1. 先人工通读首页、阅读地图、第一篇、第二篇、第八篇。
2. 再执行一次构建并抽查 lastUpdated、源码快照卡、练习模板是否正常显示。
3. 最后浏览其余章节，确认它们现在已经完成统一快照卡与练习模板接入，且没有结构性失真或明显坏链。

如果还想继续优化

下一阶段最值得做的不是大面积重写，而是继续做低漂移改进：

• 逐步把高价值源码链接改成 commit 锚定。
• 做一轮移动端与长代码块排版检查。

当前建议

以目前状态看，这本书已经接近“可发布候选版”，但最稳的做法仍然是：先把这轮统一模板和可信度检查跑完，再决定是否封版。