版本与文档基线

本手册以已私有发布的 0.13.0 为安装起点。安装与升级指南核对到 main 分支的提交 fdd31dd58b17cb12bd8e1f101385f1229c1a4a45；发行标签为 v0.13.0，发行源码提交为 2cd998460f9aa64387623a8e9c26b49abc6dca1a。文档核对提交与发行提交分别记录；当前基线中两者一致。

从私有 Releases 下载开发包，需要核心仓库读取权限；在线安装还需 GitHub Packages 中 @igwen6w/modu-web 的读取权限。项目仅通过私有渠道交付，应用仍以 @modu/web 导入前端核心。

已发布能力与模板范围

内容	当前状态
开发包、升级包与配套 Go/npm 核心	`0.13.0` 已私有发布
`core:install`、`core:upgrade`、`core:deps`、`core:tooling-upgrade`、`server:go`	已发布开发包内可用
`core:login`、`app:setup`、`app:upgrade`、`dev:all`、`services:stop`	`0.13.0` 开发包内的认证、初始化、应用数据升级与日常启动入口，均为 Node 24 原生 ESM 工具
仅 `0.7.1` 及更早的旧应用	先经 `core:tooling-upgrade` 从 Python 工具迁移到 Node ESM，再使用上述命令
仅含应用骨架与安装工具的纯在线模板包	尚未发布

当前开发包随附核心产物，按快速开始在线安装后改用线上私有源。core:upgrade 只更新核心依赖，不为旧应用补装新模板命令。源码生成工具供维护者使用，见创建独立应用。

版本号各自表示什么

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

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

文档与仓库边界

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

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

更新方式

修改核心公开行为时，同步提交相关手册更新，记录核对过的源码提交。基线信息保存在文档仓库 source-baseline.json 中。页面中的版本号、CoreAPI 和提交号以双大括号占位符（首页由 MDX 直接引用）从该文件取值，构建时替换；更新版本只需修改这一个文件。

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