封版清单

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

当前状态

基于当前仓库与最近几轮整理，这本书已经具备较强的封版候选状态：

15 篇正文结构已经统一，均包含导读块与思考题。
首页、阅读地图、章节页之间的定位已经基本对齐。
章节内源码链接已统一指向 opencode 仓库 dev 分支。
主要重章节已经完成一轮以上的正文压缩，重复铺垫明显减少。
导航、侧边栏、阅读路径和章节顺序已经稳定。

已完成项

结构与导航

[x] 首页已明确为“面向 Agent 开发初学者的 OpenCode 源码带读电子书”。
[x] 阅读地图已建立三条阅读路线与章节依赖关系。
[x] 全书 15 篇已全部接入侧边栏。
[x] editLink 已指向 GitHub dev 分支。

内容一致性

[x] 各篇已统一 对应路径 / 前置阅读 / 学习目标 头部格式。
[x] 各篇已统一 本章导读 结构。
[x] 各篇已补齐 思考题。
[x] 多篇正文开头已完成去冗余和出版式压缩。

链接与示例

[x] 本机绝对路径链接已清理。
[x] 章节内关键源码入口已大致统一为 GitHub 链接。
[x] 最近一轮已修正部分代码块里的弯引号，避免示例不可直接阅读。

构建验证

[x] 最近多轮编辑后均已执行 docs/book 下的 bun run build。
[x] 当前站点可正常构建出包。

已知非阻塞项

当前没有已确认、需要继续挂账的文档级非阻塞项。

此前根 tsconfig.json 的 @tsconfig/bun/tsconfig.json 解析告警已经修复。
当前 docs/book 可正常执行 bun run build 并完成静态构建。
如果在受限环境里运行 bun dev 遇到端口监听失败，更接近本地环境权限问题，不是站点内容或 VitePress 配置问题。

发布前建议再检查一遍

站点体验

[ ] 桌面端从首页到任意章节的阅读流是否自然。
[ ] 移动端标题、表格、代码块是否存在明显拥挤。
[ ] 阅读地图、首页按钮、侧边栏跳转是否都符合预期。

文案与术语

[x] Agent、Subagent、Primary Agent、运行时、工作台 等高频术语已经整理为固定口径表，后续主要是增量修订而不是从零补齐。
[ ] 是否还有个别章节残留“讲义式模板语气”。
[ ] 中英文引号、代码块、标题语气是否还有零星不一致。

内容边界

[x] 已补 版本说明 页，明确本书基于当前 dev 分支源码带读。
[x] 首页已补“以当前仓库实现为准，不承诺覆盖未来版本变更”的阅读边界说明。
[x] 书中已经出现“实验性能力”“当前实现状态”等边界表达，后续只需按章节需要补强，不必作为缺页问题处理。

如果现在就封版

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

先人工通读首页、阅读地图、第 1 篇、第 8 篇、第 15 篇。
再用浏览器快速点读所有章节，主要看排版而不是内容。
最后保留当前构建结果与这页清单，作为这一版的封版记录。

如果还想继续优化

下一阶段就不建议再做大面积重写，而更适合做这三类小修：

术语表：把高频概念整理成统一口径。
版本说明：补一页“本书写作范围与源码基线”。
排版精修：针对移动端和长表格再做一轮视觉检查。

当前建议

以目前状态看，这本书已经可以进入“候选发布版”。

如果你的目标是：

先交付一个可读、可学、可继续迭代的版本：现在可以封版。
追求更接近正式出版物的完成度：再做一轮人工通读和术语表整理会更稳。