目录 / 文档-技术白皮书 / 55-决策与变更记录 Template v1.0
I. 章节目标与范围(强制)
- 建立对象×维度的标准化影响评估框架,输出可量化、可比较、可回放的结论,并与状态机门禁(gate)与回滚触发器解耦/对齐。
- 评估覆盖:模型/口径/流程/数据契约/实现绑定;不含组织、人事与预算审批。
II. 评估对象与边界(强制)
- 对象分层:
- 理论与口径层(S/P/M/I 锚点);
- 数据与管线层(数据契约、处理流程、回放套件);
- 实现绑定层(API/CLI/Schema、兼容性断言);
- 运行与发布层(SLO/SLA、回滚策略)。
- 边界:仅评估技术影响面与运行影响面;商业与法务影响另行记录。
III. 维度体系与指标(强制)
- 默认维度与度量:
- 性能:gate_accuracy、AUC、RMSE 等;
- 成本:单位算力/存储/人力成本;
- 时间:gate_latency(批/流)、上线周期;
- 风险:事件率/严重度(P×S),incident_level;
- 依赖:受影响子系统数量与耦合度;
- 可复现性:回放成功率、跨环境一致性;
- 兼容性:现网回放通过率、API/Schema 破坏性变更计数。
- 门禁命名:gate_<metric><comparator><threshold>@<window>(如 gate_accuracy>=0.99@7d)。
IV. 归一化与不确定度(强制)
- 归一化:将各维原始指标映射到 [0,1],得到 s_i(大为优/小为优按目标单调映射)。
- 不确定度折减:若估计标准差为 σ_i,使用
[
s_i' = \mathrm{clamp}\bigl(s_i - k·σ_i,\ 0,\ 1\bigr),\quad k=1
] - 维度权重:w_i≥0 且 ∑ w_i = 1;总评分:S = ∑ w_i · s_i'。
- 置信表达:报告 CI_{95%} 或等价区间,并说明统计方法(如 bootstrap)。
V. 影响矩阵模板(可直接拷贝)
维度 | 指标 | 目标方向 | 基线 | 变更后 | 归一化 s_i | 标准差 σ_i | 折减后 s_i' | 权重 w_i | 备注 |
|---|---|---|---|---|---|---|---|---|---|
性能 | gate_accuracy@Eval | ↑ | 0.97 | 0.992 | 0.96 | 0.01 | 0.95 | 0.30 | CMB-Set |
成本 | Unit Cost | ↓ | 1.00 | 0.90 | 0.80 | 0.03 | 0.77 | 0.15 | 相对基线 |
时间 | gate_latency | ↓ | 2.5h | 1.8h | 0.70 | 0.05 | 0.65 | 0.10 | 批窗口 |
风险 | Incident P×S | ↓ | P98 | P99.2 | 0.85 | 0.04 | 0.81 | 0.15 | 运维口径 |
依赖 | 受影响子系统 | ↓ | 1 | 2 | 0.80 | 0.00 | 0.80 | 0.10 | 数量越少越好 |
复现性 | 回放成功率 | ↑ | 0.95 | 0.99 | 0.95 | 0.01 | 0.94 | 0.10 | 多环境 |
兼容性 | 现网回放 | ↑ | 0.98 | 0.995 | 0.97 | 0.01 | 0.96 | 0.10 | API 回放 |
总分 S | — | — | — | — | — | — | ∑ w_i·s_i' | 1.00 | — |
VI. 路径/公式一致性(强制)
- 若评估涉及到达时判据,统一使用:
- 常量外提:T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
- 一般口径:T_arr = ( ∫ ( n_eff / c_ref ) d ell )
- 文中出现 T_arr 时,同段或紧邻段落显式声明路径 gamma(ell) 与测度 d ell;所有量纲校核需通过 check_dim。
- 禁混:T_fil≠T_trans,n≠n_eff,c≠c_ref;公式/符号/定义禁用中文。
VII. 风险分级与触发器(强制)
- 等级:L1(轻微)/L2(中等)/L3(严重)/L4(致命),按影响面与恢复成本分级。
- 触发器示例:gate_accuracy<0.98@7d、gate_latency>2h@7d、incident_level≥2、data_drift>0.03@14d。
- 处置:达到触发器时进入回滚分支;生成 RollbackReport 与再实施条件(见第4章)。
VIII. 依赖、兼容性与覆盖率(强制)
- 依赖映射:列出受影响的 S/P/M/I 锚点与系统组件,标注破坏性变更(Breaking=true/false)。
- 兼容声明:对 API/Schema 给出版本区间与退化路径(fallback);对回放套件给出覆盖率(coverage@dataset)。
IX. 机读 Schema(YAML;JSON 等价,可直接拷贝)
impact:
dimensions:
performance:
metric: "gate_accuracy"
target: ">=0.99@7d"
baseline: 0.97
after: 0.992
normalize: { mode: "higher_is_better", to: [0,1] }
sigma: 0.010
weight: 0.30
cost:
metric: "unit_cost"
target: "<=1.0x@base"
baseline: 1.00
after: 0.90
normalize: { mode: "lower_is_better", to: [0,1] }
sigma: 0.030
weight: 0.15
latency:
metric: "gate_latency"
target: "<=2h@7d"
baseline: "2.5h"
after: "1.8h"
normalize: { mode: "lower_is_better", to: [0,1] }
sigma: 0.050
weight: 0.10
risk:
metric: "incident_ps"
target: "P99@window"
baseline: "P98"
after: "P99.2"
normalize: { mode: "higher_is_better", to: [0,1] }
sigma: 0.040
weight: 0.15
dependency:
metric: "affected_subsystems"
target: "<=2"
baseline: 1
after: 2
normalize: { mode: "lower_is_better", to: [0,1] }
sigma: 0.000
weight: 0.10
reproducibility:
metric: "replay_success"
target: ">=0.98"
baseline: 0.95
after: 0.99
normalize: { mode: "higher_is_better", to: [0,1] }
sigma: 0.010
weight: 0.10
compatibility:
metric: "prod_replay_pass"
target: ">=0.99"
baseline: 0.98
after: 0.995
normalize: { mode: "higher_is_better", to: [0,1] }
sigma: 0.010
weight: 0.10
scoring:
k_sigma: 1.0
formula: "S = sum_i(w_i * clamp(s_i - k*sigma_i, 0, 1))"
dependencies:
anchors:
- "EFT.WP.Core.Equations v1.1:S20-1"
- "EFT.WP.Core.Metrology v1.0:check_dim"
- "EFT.WP.Core.DataSpec v1.0:I30-2"
systems:
- { name: "pipeline.arrival_time", breaking: false }
- { name: "api.metrics.v2", breaking: true }
compatibility:
api_schema:
version_range: "[2.0,3.0)"
fallback: "v1 adapter enabled"
replay:
coverage:
datasets: { "cmb_set_v3": "0.995", "lens_v1": "0.992" }
triggers:
- "gate_accuracy<0.98@7d"
- "gate_latency>2h@7d"
- "incident_level>=2"
- "data_drift>0.03@14d"
X. 人读 × 机读对位(强制)
人读段落 | 机读字段 | 校核要点 |
|---|---|---|
评估对象与范围 | impact.dimensions.*,dependencies.* | 维度齐备,依赖含锚点 |
度量与门禁 | impact.dimensions.*.metric/target | 命名口径与门禁一致 |
归一化与不确定度 | scoring.k_sigma,各维 sigma | 折减计算可回放 |
兼容性与覆盖 | compatibility.* | 版本区间与回放覆盖率 |
触发器与回滚 | triggers[] | 与第4章状态机闭环 |
结论与建议 | 由总分 S 与硬门禁结果推导 | 记录例外与退出条件 |
XI. 最小填写示例(可直接拷贝)
impact:
summary:
hard_gates_passed: true
S: 0.91
ci95: [0.88, 0.93]
key_findings:
- "性能 ≥0.99@7d,复现性与兼容性显著提升"
- "成本较基线下降 ~10%,依赖面适度扩大(+1 子系统)"
recommendation: "进入 Approved;保留 API v1 适配器 30 天作为回退缓冲"
XII. 结论表达(强制)
- 硬门禁优先:任一硬门禁未通过则返回 Review 或进入回滚评估;通过后方可进入评分与排序。
- 总分驱动:报告 S 与 CI,给出排名与不做清单;对例外条款与退出条件做结构化记录(与第3章字段对齐)。
- 回滚准备:同时输出监控指标、阈值与复原步骤入口,确保一键回退可操作。
版权与许可(CC BY 4.0)
版权声明:除另有说明外,《能量丝理论》(含文本、图表、插图、符号与公式)的著作权由作者(“屠广林”先生)享有。
许可方式:本作品采用 Creative Commons 署名 4.0 国际许可协议(CC BY 4.0)进行许可;在注明作者与来源的前提下,允许为商业或非商业目的进行复制、转载、节选、改编与再分发。
署名格式(建议):作者:“屠广林”;作品:《能量丝理论》;来源:energyfilament.org;许可证:CC BY 4.0。
首次发布: 2025-11-11|当前版本:v5.1
协议链接:https://creativecommons.org/licenses/by/4.0/