版本与文档基线

本手册对应核心打包重构后的 0.7 开发基线，核对源码提交为 9dba96148c273699cd24dad4c0631f7d73323544，位于 codex/core-packaging 工作分支。

该基线尚未合入 main，核心包也尚未正式发布。开始前由维护者提供对应源码或私有产物。文档内容不表示某个版本已可从公开 registry 安装。

版本号各自表示什么

版本	当前基线	用途
Go 核心包	v0.7.0	后端平台实现
@modu/web	0.7.0	前端平台实现，与 Go 核心配套
扩展 CoreAPI	0.12.0	扩展与宿主合同兼容性
扩展发行版本	各扩展独立	某个扩展的交付
合同 / schema 版本	各合同独立	贡献语义或持久化结构
文档站版本	0.1.0	文档工程自身的发布

这些数字不能相互替代。不要将 CoreAPI 写入 npm 依赖，也不要根据文档站版本选择核心包。

文档与仓库边界

• 核心仓库：核心实现、starter、精确接口合同、架构决策与验收证据。
• 文档仓库：使用手册、开发指南、升级说明与本站工程。
• 业务仓库：应用代码、配置、迁移及自有扩展。

设计稿中的计划、历史阶段名称和测试报告不会自动成为已交付能力。有冲突时先核对同版本公开接口与当前实现。

更新方式

修改核心公开行为时，同步提交相关手册更新，记录核对过的源码提交。基线信息保存在文档仓库 source-baseline.json 中。

开发阶段先维护一套当前手册。存在多条受支持发行线后，再引入版本化文档，避免提前复制大量相同页面。