发布与变更规则¶
版本口径¶
项目使用语义化版本:
- major:公开 URL 或内容 schema 出现不兼容变化;必须提供迁移或重定向方案。
- minor:新增目录、搜索、质量门禁或生产流水线能力。
- patch:修复事实、链接、样式或工具缺陷,不改变公开契约。
VERSION 是当前版本的唯一机器可读来源,CHANGELOG.md 的最新版本必须与它一致。
每批变更必须记录¶
- 至少一个
IOT-Txxx;修复问题时同时记录IOT-Fxxx。 - 影响文件和是否存在迁移要求。
- 可在干净工作树复现的验证命令。
- 审查基线 commit;使用交接包时记录 ZIP SHA-256,但不能记录本机路径。
批次边界¶
- 一个批次只处理一个并行组或一个可回滚主题。
- 机械元数据迁移不能和文章正文重写混在同一批。
- 只有自动门禁通过且必要的手工验收有证据时,才能把任务标为
VERIFIED。 - Layer 3–8 扩容必须先通过 shadow pilot,正式发布每批最多 5 篇。