制品标识、发布与回滚

关联版本、内容摘要与清单

需能阅读文件清单和摘要。本地制品示例用 Python 3.11+ 标准库与 zlib，把 payload/README.txt 打成 ZIP，并记录字节数与 SHA-256；输出目录必须全新。本页解释标识、晋级和回滚前提，示例只打包、不发布。 示例未在本轮执行。

制品 唯一标识

制品唯一标识要关联源码提交和构建输入。相同版本号不能被静默替换不同字节；文件名便于人读，摘要用于核对实际内容，二者解决不同问题。

发布 语义版本

发布语义版本以公开API为前提：主版本表达不兼容，次版本表达兼容新增，补丁表达兼容修复。预发布标识表示尚未稳定的版本，不能仅凭版本号承诺数据库迁移可逆。

制品 清单

制品清单列出文件名、字节数、SHA-256和来源说明。摘要验证内容一致性，不能证明来源可信；签名需要单独的信任根与密钥管理，本例不生成或宣称签名。

依据与适用范围

• 本课官方依据，资料核对日2026-10-17。

以上依据用于解释本文列明的规则；示例未执行，不代表产品全部能力或跨平台验证。历史资料的版本、账号与界面位置需按目标环境确认。

编写发布说明并确认回滚前提

发布 变更说明

发布变更说明按使用者影响组织新增、修复、不兼容和迁移步骤。关联提交可追溯实现，但提交日志不等于发布说明；明确需要用户操作的配置变更和数据兼容边界。

制品 环境晋级

制品环境晋级应移动同一不可变制品，环境配置单独注入。每个环境重新构建会让已验收字节与上线字节不同；记录晋级审批和目标，不在本课执行部署。

发布 回滚前置

发布回滚前置包括旧制品可取、配置兼容和数据向后兼容。恢复二进制不自动恢复数据；迁移删除字段后旧程序可能无法读取，应先采用扩展再收缩或准备独立恢复方案。

检查摘要、版本排序与保留范围

制品 校验不符

制品校验不符先停止使用并对比下载来源、摘要算法和文件字节。换行、压缩元数据或截断都可能改变摘要；重新计算并不能证明哪个来源正确，需要回到可信清单。

发布 预发布排序

发布预发布排序按SemVer规则比较点分标识，数字标识按数值比较。1.0.0-rc.2低于1.0.0-rc.10，两者都低于1.0.0；不能用普通字符串排序选择稳定版本。

制品 保留策略

制品保留策略由回滚窗口、审计需要和存储成本共同决定。清理前确认部署仍引用哪些摘要，不能只按最新几个文件删除；备份与保留是不同控制，需验证恢复来源。