48-实验协议卡 Template v1.0 | 第10章 异常处理与回退策略

目录 ／ 文档-技术白皮书 ／ 48-实验协议卡 Template v1.0

第10章 异常处理与回退策略

I. 目的与范围（Purpose & Scope）

• 将观测/采集过程中可能出现的异常事件归类、设阈并规范触发—响应闭环；给出回退路径、记录口径与发布限制，确保安全、计量闭合与可审计。
• 适用：timing / imaging / spectral / mixed 模式；当涉及路径量（到达时/相位）时，正文显式 gamma(ell) 与测度 d ell，并记录 delta_form ∈ {general, factored}。

II. 异常类别与触发条件（Event Classes & Triggers）

• 时间同步类（SYNC）：clock_state != locked 超过宽限；|δt_abs|、|Δτ_ch|、σ_y(τ) 超阈。
• 计量闭合类（DIM）：p_dim < 1 或 check_dim 失败；单位/量纲缺失。
• 采样与路径类（SMP/PATH）：f_s < 2 f_max、Δt > λ_ref/(2 c_ref)、Δell > Δell_max、len(path) < 2；路径–测度不同步。
• 近轴/相干窗类（PAX/COH）：|θ| > θ_max；或 |∇ n_eff|·L_coh ≮≪ 1。
• 噪声与残差类（NOISE）：Q_res 越界、重尾/异方差显著；ε_flux 守恒失配。
• 校准新鲜度类（CALIB）：|ts_start − calib.timestamp| > τ_calib 或 u(θ_k) 超限。
• 引用与版本类（CITE/VER）：ver_presence < 1、锚点直指率 < 90%、存在外链/别名。
• 数据完整性类（INTG）：record_id 重复、checksum 冲突、audit.jsonl 缺失关键事件。

III. 回退与处置矩阵（Fallback Matrix）

IV. 执行步骤（Operational Steps）

• 检测：在线滚动计算 Q_res, p_dim, σ_y(τ), δt_abs, Δτ_ch, ε_flux, SNR；每 Δt_beat 出心跳并判断阈值。
• 决策：依据 II 节触发条件匹配 III 节矩阵，确定立即动作 + 回退路径。
• 切换：按优先级执行（SYNC→DIM→SMP/PATH→PAX/COH→NOISE→CALIB→CITE/VER→INTG），避免震荡切换；切换时冻结当前批次。
• 记录：在 audit.jsonl 写入事件（时间、阈值、前后配置、随机种子、输入哈希）；若进入限制模式，统一加 [Restricted]。
• 复位：满足恢复条件后，解冻批次；失败≥N 次进入人工复核队列。

V. 与质量门对齐（Alignment with Gates）

• 任何触发 S1–S5（见第 8 章）即刻停批并进入本章矩阵；放行前需再次通过 G1–G8。
• 回退期间的结果仅可发布定性说明与诊断图，不得对外给出定量承诺。

VI. 输出与导出（Outputs & Exports）

• 报告：quality_report.json（含触发/回退/恢复时间线、越界值与当前阈值）、check_dim_report.json 更新版、audit.jsonl。
• 清单：更新 manifest.yaml 的 see[]/references[]/version/checksum；限制模式需在图表标题后统一附 [Restricted]。

VII. 引用与版本（Citations & Versioning）

• 固定写法：见《<卷名> vX.Y》<章节> <锚点>；优先 P/S/M/I。
• 规范锚点（示例）：EFT.WP.Core.Metrology v1.0:check_dim、EFT.WP.Metrology.TimeBase/Sync/Instrument/PathCorrection v1.0、EFT.WP.Core.Equations v1.1:S20-1/S21-2、PTN Template v1.0 Ch.5/7/8/11。
• 对外仅用 v1.*；若用 v0.*，显著标注“草案/非承诺”。

VIII. 机读模板（Machine-Readable，最小片段）
A. fallbacks.yaml

version: "1.0.0"

triggers:

SYNC: ["clock_unlocked","abs_t_over","skew_over","allan_over"]

DIM: ["p_dim_fail","check_dim_fail"]

SMP: ["fs_below_nyquist","Delta_ell_over","path_len_short","path_desync"]

PAX: ["theta_over","coherence_fail"]

NOISE: ["Q_res_over","flux_nonconserve"]

CALIB: ["tau_calib_expired","u_theta_over"]

CITE: ["ver_missing","anchor_coverage_low","external_link_found"]

INTG: ["record_dup","checksum_dup","audit_missing"]

actions:

sync_fallback: ["GNSS","PTP","NTP"]

switch_fullwave: true

segment_adapt: { T_coh: "shrink", L_coh: "shrink", B_coh: "increase" }

robust_substitute: ["huber","quantile"]

recalibrate: true

labels:

restricted: "[Restricted]"

B. quality_report.json（字段示例）

{

"run_id":"01JXYZABCD...",

"timeline":[

{"t":"...","event":"clock_unlocked","level":"error"},

{"t":"...","event":"sync_fallback","to":"PTP","level":"action"},

{"t":"...","event":"p_dim_fail","level":"fatal"}

],

"metrics":{"p_dim":0.96,"Q_res":0.25,"epsilon_flux":0.03,"delta_t_abs_ns":120,"allan_1s":3e-11},

"restricted": true

}

IX. 执行勾选清单（Checklist）

• 已加载阈值与回退配置；在线监测与心跳正常。
• 触发事件按 III 节矩阵执行，切换与暂停/恢复均有审计记录。
• 进入限制模式时，所有图表与结果已标注 [Restricted] 并列出触发项。
• 放行前复验 G1–G8 通过；check_dim_report.json/quality_report.json/audit.jsonl 已更新。
• manifest.yaml 内 see[]/references[]/version/checksum 与正文一致；引用合规、版本锁定。