26-EFT.WP.STG.Lensing v1.0 | 附录D 指标与漂移度量（透镜专属）

目录 ／ 文档-技术白皮书 ／ 26-EFT.WP.STG.Lensing v1.0

附录D 指标与漂移度量（透镜专属）

一句话目标：定义透镜（谱域/几何/物理/学习/运行时）的统一指标族与漂移度量，提供口径、阈值与窗口化规则，并与清单与契约闭环。

I. 范围与对象

• 对象：K（单层核）、K_eff（组合透镜）、graph, visibility, y_spec/y_var（两口径输出）、RefCond、运行时 SLI/ SLO。
• 输入：训练与评测数据、谱响应、物理一致度量、面板遥测、历史参照 ref@ts0。
• 输出：指标集 metrics.lens.*、漂移分解 drift.*、契约判定 C71-* 标注与证据 URI。

II. 名词与变量

• G(k)：核在谱域的增益，k ∈ spec(graph)；unit(G)= "-", dim(G)="1"。
• T_trans：透过率；boundary_residual = || B y ||_2；conservation_residual。
• delta_form = ( || y_spec - y_var ||_2 / || y_spec ||_2 )；tol_form。
• vis_score ∈ [0,1]；los_ratio；mask。
• err_rec（反演/去透镜误差），ece（校准误差），latency（ms），drift_score（[0,1]）。
• 时间与窗口：tau_mono 计算时基，滑动窗口 W = [ts - Δt, ts]。

III. 公设 P71D-*

• P71D-1：所有指标落盘须同时给出 unit(field) 与 dim(field)，并通过 check_dim( y - f(x) )。
• P71D-2：两口径指标与物理指标必须可重放，依赖数据以 URI 形式外链，不在清单内重复存储。
• P71D-3：漂移度量必须可分解并可归因到谱/可见性/物理/数据/拓扑五类。

IV. 最小方程 S71D-*

1. 两口径一致性
   • S71D-01：delta_form = ( || y_spec - y_var ||_2 / || y_spec ||_2 )；delta_form_p{q} 为分位数。
   • S71D-02：latency_gap = | latency_spec - latency_var |。
2. 谱域与核稳定
   • S71D-11：gain_sup = sup_k | G(k) |；passband_ripple = sup_{k∈P} | G(k) - G0(k) |。
   • S71D-12：leakage = ∫_{k∈S} | G(k) | d k / ∫_{k∈all} | G(k) | d k（声明 k 的测度）。
   • S71D-13：rho_bound = spectral_radius( K_eff )。
3. 物理一致与边界
   • S71D-21：T_trans = ( E(y; M) / E(x; M) )；conservation_residual = | T_trans - T_ref |。
   • S71D-22：boundary_residual = || B y ||_2。
4. 可见性与遮挡
   • S71D-31：vis_score = mean( mask )；los_ratio = |LOS| / ( |LOS| + |NLOS| )。
   • S71D-32：vis_dice = ( 2 ⟨mask, mask_ref⟩ / ( ||mask||_1 + ||mask_ref||_1 ) )。
5. 反演与重建质量
   • S71D-41：err_rec = ( || x_hat - x ||_2 / || x ||_2 )；err_rec_p{q} 为分位。
   • S71D-42：sparsity = ( || Φ x_hat ||_0 / N )（Φ 为稀疏变换）。
6. 可靠性与校准（学习型）
   • S71D-51：ece = ∑_b ( | acc_b - conf_b | * w_b )。
   • S71D-52：reliability_gap = sup_p | F_pred(p) - F_emp(p) |。
7. 运行时 SLI
   S71D-61：latency_p{q}；cpu_pct, mem_pct, err_rate；cache_hit。
8. 漂移分解与聚合
   • S71D-71（谱漂移）：drift_spec = ( ∫ | G_t(k) - G_ref(k) | d k / ∫ | G_ref(k) | d k )。
   • S71D-72（可见性漂移）：drift_vis = | vis_score_t - vis_score_ref |。
   • S71D-73（物理漂移）：drift_phys = w1 * | T_trans_t - T_ref | + w2 * boundary_residual_t。
   • S71D-74（数据漂移）：drift_data = MMD( x_t, x_ref ) 或 KS( feat_t, feat_ref )（声明统计测度）。
   • S71D-75（拓扑漂移）：drift_graph = ( || L_t - L_ref ||_F / || L_ref ||_F )（L 为图拉普拉斯）。
   • S71D-79（聚合）：drift_score = α*drift_spec + β*drift_vis + γ*drift_phys + δ*drift_data + ζ*drift_graph，系数 α…ζ 归一化并落盘。

V. 计量流程 M71-D*

• 就绪：确定参照 ref@ts0、时间窗口 Δt、采样策略与测度；加载 RefCond。
• 计算：并行生成谱域、物理、可见性、反演、运行时五类指标；两口径同步计算 delta_form。
• 聚合：在窗口 W 内计算分位与滑动统计（p50/p90/p99、EWMA）；生成 drift_* 与 drift_score。
• 校核：应用 C71-* 契约；对违约项生成证据 URI 与标注。
• 落盘：写入 manifest.lens.metrics.* 与面板快照哈希；签名并发布。

VI. 契约与阈值建议 C71D-*

• C71D-01 TwoFormDelta：delta_form_p99 ≤ tol_form（默认 tol_form ∈ [0.01, 0.05] 视业务定）。
• C71D-11 SpectralGainBound：gain_sup ≤ 1.2；passband_ripple ≤ 0.05；leakage ≤ 0.02。
• C71D-21 TransmissionBalance：| T_trans - T_ref | ≤ 0.02；boundary_residual ≤ 0.01。
• C71D-31 VisibilityHealth：vis_score ≥ 0.6；|los_ratio - los_ratio_ref| ≤ 0.1。
• C71D-41 InversionQuality：err_rec_p90 ≤ 0.15；sparsity ≤ s_max（由任务设定）。
• C71D-51 Reliability：ece ≤ 0.03；reliability_gap ≤ 0.05。
• C71D-61 RuntimeSLO：latency_p99 ≤ L_max；err_rate ≤ 1e-3；cache_hit ≥ 0.8。
• C71D-71 DriftGuard：drift_score ≤ τ_drift；分解项若任一超过其子阈值则进入降级策略。

VII. 实现绑定 I71-*（指标与漂移）

• compute_lens_metrics(x, y_spec, y_var, K_eff, graph, RefCond) -> metrics
• estimate_spectral_response(K_eff, graph) -> {G(k), gain_sup, ripple, leakage}
• measure_physical_consistency(x, y, B, M) -> {T_trans, boundary_residual, conservation_residual}
• calc_visibility(mask, los_sets) -> {vis_score, los_ratio, vis_dice}
• infer_inversion_quality(x_hat, x, Phi) -> {err_rec, sparsity}
• aggregate_runtime_sli(stream) -> {latency_p{q}, cpu_pct, mem_pct, err_rate, cache_hit}
• compute_drift(metrics_t, metrics_ref, graph_t, graph_ref, policy) -> {drift_*, drift_score}
• 不变量：check_dim(*) 为真；rho_bound < 1（稳定性）；non_decreasing(ts)；证据 URI 可解且可校验哈希。

VIII. 交叉引用

• 透镜核与谱域：见第5章。
• 可见性与遮挡：见第4章。
• 去透镜/反演：见第7章。
• 多层组合与稳定：见第8章。
• 学习与可靠性：见第9章。
• 物理一致：见第10章。
• 运行时面板与 SLO：见第11章。
• 清单落盘：见第15章与附录C。
• 契约库：见附录B（C71-*）。

IX. 质量与风控

1. SLO 例：delta_form_p99 ≤ 0.02，latency_p99 ≤ 50 ms，drift_score ≤ 0.3。
2. 漂移响应分级：
   • 0.3 < drift_score ≤ 0.5：触发重标定候选，增加 EWMA 权重衰减。
   • 0.5 < drift_score ≤ 0.7：启用保守核（降增益），局部回退至 K_baseline。
   • drift_score > 0.7：硬回退 + 提醒人工审计，冻结学习更新。
3. 审计：每次阈值变更写入策略卡版本与证据；面板快照与清单签名一致性校核。

小结

• 本附录给出透镜指标与漂移的口径、阈值与流程，支持从谱→物理→可见性→学习→运行时的端到端度量闭环；
• 与 manifest.lens、C71-* 契约和 I71-* 接口一致，实现可追溯、可回放与可回退。