版本与发布记录
算法版本 / 规则版本 / 应用版本的统一发布台账：发布内容、影响范围、发布人、回滚点；灰度发布的范围、比例、观察期与结论；任意两个版本之间的参数与规则逐项差异对比，以及回滚影响评估。
!发布治理口径：任何算法 / 规则 / 应用版本都必须留下四件套 —— 发布记录（谁、何时、改了什么、影响谁）、回滚点（可一键回退到哪个版本）、灰度记录（范围、比例、观察期、结论）、版本对比（参数与规则的逐项差异）。没有回滚点的发布不允许上线（X7 + S5）。
当前算法版本
v2.4.1
PRED-WMA · 灰度 30%（浙江 7 家门店）
当前规则版本
R2025.10.3
全国 TOP20 满足周数 1.8 周
当前应用版本
v3.7.2
2025-10-19 发布，全量生效
本月发布
6次
算法 2 / 规则 3（含 1 次驳回）/ 应用 1
可用回滚点
12个
每类版本保留最近 3 个回滚点
灰度进行中
1个
G-20251020-02 · 剩余观察 6 天
发布记录
算法 / 规则 / 应用三类版本统一台账| 版本号 | 类型 | 发布时间 | 发布人 | 内容摘要 | 影响范围 | 状态 | 回滚点 |
|---|---|---|---|---|---|---|---|
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
共 38 条发布记录（近 90 天 18 条，本页展示 8 条）；每条发布必须关联回滚点，缺失则标记为不合规发布每页
版本对比 · v2.3.6 → v2.4.1（参数与规则逐项差异）
逐项差异 + 影响，而不是“已优化若干项”| 参数 / 规则项 | 旧版本 v2.3.6 | 新版本 v2.4.1 | 差异 | 回测 / 预演影响 |
|---|---|---|---|---|
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
共 26 项差异（本页展示 8 项）；差异为 0 的项默认折叠，避免噪声淹没关键变化每页
对比页要能回答“值不值得发”
版本对比不只是列新旧值，而是把差异 → 回测/预演影响 → 是否可接受连成一句话。本版本的结论是：MAPE 改善 0.7pp、新品冷启动改善 3.4pp，可继续灰度；唯一风险是全量后目标库存上抬带来陈列压力，因此灰度范围限定在门店库容充足的 7 家门店。
回滚点与回滚操作
回滚前必须生成影响评估- 影响 SKC
- 96 个（占 382 个的 25.1%，全部为单店周销前 10% 的 TOP 款）
- 影响门店
- 85 家（灰度范围 7 家先行，其余按全量口径回退）
- 决策行 / 补调量
- −42 行 / −61 件（474 → 413 件）
- 下游单据
- 18 张：未下发 6 张自动作废；已下发 12 张不可自动回滚，需人工红冲
- 成本影响
- −¥18,400（退回 ¥377,100 基线）
- 回滚耗时
- 预计 8 分钟（含批次重算与验证），无需重启服务
回滚不是“撤消按钮”
回滚只能撤系统内的版本；已经下发到 ERP / WMS 的单据撤不回来。所以回滚影响评估必须明确列出“已下发单据有几张、需要谁去红冲”，并且默认要求人工二次确认。
灰度发布记录
灰度是发布流程的一部分，不是“先上一点试试”| 灰度批次 | 版本 | 灰度范围 | 比例 | 开始时间 | 观察期 | 核心指标 | 结论 |
|---|---|---|---|---|---|---|---|
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
| — | — | — | — | — | — | — | — |
共 5 个灰度批次（进行中 1 / 放量 3 / 回滚 1）；灰度必须写明范围、比例、观察期与结论，否则视为未完成发布每页
STEP 1
选定灰度范围
按区域 / 门店等级
STEP 2
按比例生效
10% → 30% → 100%
STEP 3
观察期评估
3–7 天 · 指标对照
STEP 4
结论与放量
放量 / 延长 / 回滚
STEP 5
全量复盘
沉淀到版本记录
版本 × 算法参数绑定
版本与参数集必须一一对应，禁止游离参数| 版本 | 类型 | 参数集版本 | 参数项数 | 绑定状态 |
|---|---|---|---|---|
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
| — | — | — | — | — |
回滚演练与运行记录
2025-10-19 14:00 · 演练
算法参数集 v2.4.1 → v2.3.6 切换，22 分钟完成（含批次重算与 12 项结果校验）
2025-10-10 08:05 · 实战回滚
PRED-WMA v2.3.6 全量回退：MAPE 劣化 0.3pp，回滚耗时 8 分钟，未影响当日批次
2025-09-20 10:30 · 演练
应用版本 v3.7.0 → v3.6.4 回退，45 分钟（含前端缓存刷新与门店端提示）
2025-09-05 15:20 · 演练
规则版本回退并复算 330 行决策，与历史结果差异 0 行（复算一致性验证通过）
S5 版本与发布记录 X7 算法治理 M12 规则预演
近 90 天发布节奏
共 18 次发布；参数集微调也需留痕发布合规自检
| 自检项 | 结果 | 说明 |
|---|---|---|
| 是否存在无回滚点的发布 | 0 条 | 38 条发布全部关联回滚点 |
| 是否存在未观察即放量的灰度 | 0 条 | 最短观察期 3 天，系统强制 |
| 回滚点是否经演练验证 | 11 / 12 | VP-20251008-02（清残码）待演练 |
| 是否存在跨版本混用参数 | 0 条 | 参数集与算法版本一一绑定 |
| 已下发单据能否自动回滚 | 否（口径已写明） | 回滚评估强制列出需人工红冲的单据数 |
本页标签与联动
L6S5X7P1
发布记录 版本对比 回滚点 回滚影响评估 灰度范围 灰度比例 观察期结论 放量 算法热切换 复算一致性
i设计说明（S5）：版本页最容易被做成“更新日志列表”。企业级要求是把它做成治理台账：每个版本都要有可回滚点、有灰度记录与结论、有逐项差异对比，并且回滚时必须给出影响评估（尤其“已下发到 ERP 的单据撤不回来”这条硬约束要写在页面上）。