附录B 契约库与策略卡(C50 全集)


一句话目标:给出 TBN 计量从数学基线→采集→估计→时延与修正→仪器计量→频谱/时域一致→解析/观测/锚→不确定度→运行可执行契约 C50-*与“策略卡”处置流程,刚性保证两口径并行 + 同窗同带宽同单位 + 量纲合规 + RefCond 可追溯,并支撑清单化发布与回放审计。


I. 范围与对象


II. 命名、级别与通用字段


III. 域级契约总表(C50 全集)

如与场景化阈值冲突,以用例/环境化阈值为准(写入 contracts.thresholds)。缺省单位/量纲:unit(z)=1,unit(T)=[T]。


2x 数学基线(相位/频率/到达时)


3x 采集前端与时标


4x 相位与频偏估计(PLL/IQ/FFT/Hilbert)


5x Allan 家族


6x 链路时延与抖动


7x 路径与环境修正


8x 仪器与处理链


9x 频谱与时域一致


10x 解析 vs 观测 vs 锚/回放


11x 不确定度与 guardband


12x 契约与策略

C50-1201…1222:见第12章(两口径/对齐/谱门/新鲜度/覆盖/签名/旁路等)。

13x 运行流式


14x 安全与完整性


15x 端到端


IV. 策略卡(YAML 模板与典型卡)


模板

card_id: <string>

triggers: [C50-xxxx, ...]

sev: blocker|high|medium|low

decide:

if: "<metric> comparator <threshold>" # 或布尔表达式

act:

- api: I50-xx

params: {...}

- api: I50-yy

params: {...}

verify:

metric: <name>

window: "W=5min,p95"

rollback:

plan: "<bypass|lower_order|rollback_version>"

notes: "<why/impact/evidence_uri>"


典型策略卡

  1. card.twoform_guard(两口径差超限)
  1. card.align_fix(对齐差超限)
  1. card.spectrum_recompute(谱门违约)
  1. card.mapping_dualpub(相/群映射超限)
  1. card.source_refresh(新鲜度/覆盖不足)
  1. card.security_failclosed(签名/旁路/异常)

V. 阈值建议与标定


VI. 清单字段(manifest.tbn.contracts 最小键)


VII. 接口映射


VIII. 交叉引用

第2–15章(P/S/M/I/C);附录 A(接口)/C(清单)/D(指标)/E(不确定度);配套《TimeBase/Sync》《PathCorrection》《Packets.Light》《PathRedshift》《Instrument》《Methods.Cleaning》。

小结