21-EFT.WP.Metrology.Sync v1.0 | 附录C 清单模板与样例（sync manifest）

目录 ／ 文档-技术白皮书（V5.05） ／ 21-EFT.WP.Metrology.Sync v1.0

附录C 清单模板与样例（sync manifest）

I. 作用与范围

• 给出同步域发布清单 manifest.sync 的最小键集、单位口径与落盘样例，用于审计、回放与跨卷对接（Cleaning/TimeBase/CrossStats）。
• 一切统计与窗口均在 tau_mono 上计算，对外以 ts 发布；涉及到达时必须并行记录两口径与 delta_form。

II. 命名、版本与落盘规则

• 命名空间：manifest.sync.*；模式版本：schema_ver="sync.manifest/1.0.0"（语义化版本）。
• 清单为不可变对象；以 hash_sha256(blob) 与 signature 保证追溯。
• 变量、公式、键名一律使用英文与文本格式；单位用 unit(x)、量纲用 dim(x) 明示。

III. 顶层结构（键分组）

• schema_ver, TraceID, release（tag, ts）
• id（rid, pid, pk）
• timebase（tau_mono, ts_map, offset/skew/J）
• protocol（mode, ptp, ntp, synce, wr）
• link（pdv, asym, media）
• arrival（gamma, c_ref, T_arr.form1/form2/delta_form, tol_Tarr）
• servo（type, bw_hz, damping, t_lock）
• metrics（offset, skew, jitter, allan/hdev, latency）
• topology（gm, bc_layers, redundancy）
• contracts（id, status, value, threshold, window）
• slo（targets, window, burn_rate）
• audit（events, hash, signature）

IV. 关键字段与单位口径

• offset：单位 s，dim="[T]"；统计字段含 p50/p95/p99/mean/std。
• skew：单位 s/s，dim="1"；同上统计分位。
• J（jitter）：J_rms、J_pp，单位 s。
• PDV：单位 s；pdv.p99 为发布主指标。
• asym：单位 s，链路非对称估计值。
• T_arr.form1 = ( 1 / c_ref ) * ( ∫ n_eff d ell )；T_arr.form2 = ( ∫ ( n_eff / c_ref ) d ell )；delta_form = | form1 - form2 |；单位 s。
• Adev/Hdev：{tau, value} 数组；tau 单位 s，value 无量纲。
• 所有时间戳 ts 使用 ISO8601 UTC；窗口 window="300s" 文本秒制。

V. 最小必填键（发布闸门）

• schema_ver, TraceID, release.tag, release.ts
• timebase.tau_mono.ref, timebase.offset/skew/J
• protocol.mode[*] 至少一项
• arrival.T_arr.form1, arrival.T_arr.form2, arrival.delta_form, arrival.tol_Tarr
• metrics.offset.p99, metrics.skew.p99, link.pdv.p99
• contracts[*] 至少覆盖 C60-sync-31, C60-link-01, C60-arr-71
• audit.hash, audit.signature

VI. 模板（可直接拷贝并填写）

{

"schema_ver": "sync.manifest/1.0.0",

"TraceID": "trace-xxxxxxxx",

"release": { "tag": "rYYYYMMDD.N", "ts": "YYYY-MM-DDTHH:MM:SSZ" },

​

"id": { "rid": "run-xxxx", "pid": "pipeline-xx", "pk": "sync:site:clock" },

​

"timebase": {

"tau_mono": { "ref": "clk://rb-1pps", "window": "300s" },

"offset": { "unit": "s", "p50": 0.0, "p95": 0.0, "p99": 0.0, "mean": 0.0, "std": 0.0 },

"skew": { "unit": "s/s", "p50": 0.0, "p95": 0.0, "p99": 0.0 },

"J": { "unit": "s", "rms": 0.0, "pp": 0.0 }

},

​

"protocol": {

"mode": ["PTP","SyncE"],

"ptp": { "profile": "G.8275.1", "domain": 24, "ann_interval": 1, "ts_source": "hw" },

"synce": { "esmc": "Q-L-PRS", "prio": 4 }

},

​

"link": {

"media": "fiber",

"pdv": { "unit": "s", "p95": 0.0, "p99": 0.0 },

"asym": { "unit": "s", "estimate": 0.0, "method": "calibrated" }

},

​

"arrival": {

"gamma": "path://siteA->siteB",

"c_ref": 299792458.0,

"T_arr": {

"form1": 0.0,

"form2": 0.0,

"delta_form": 0.0,

"unit": "s",

"tol_Tarr": 1e-9

}

},

​

"servo": { "type": "PLL", "bw_hz": 0.2, "damping": 0.7, "t_lock": 12.3 },

​

"metrics": {

"latency": { "unit": "s", "p99": 0.0 },

"offset": { "unit": "s", "p50": 0.0, "p95": 0.0, "p99": 0.0 },

"skew": { "unit": "s/s", "p50": 0.0, "p95": 0.0, "p99": 0.0 },

"jitter": { "unit": "s", "rms": 0.0, "pp": 0.0 },

"allan": { "adev": [ { "tau": 1.0, "value": 0.0 }, { "tau": 10.0, "value": 0.0 } ] },

"hdev": { "hdev": [ { "tau": 100.0, "value": 0.0 } ] }

},

​

"topology": {

"gm": { "id": "gm-xxxx", "class": "G8272.1" },

"bc_layers": 2,

"redundancy": 2

},

​

"contracts": [

{ "id": "C60-sync-31", "status": "pass", "value": 0.0, "threshold": 1e-6, "window": "300s" },

{ "id": "C60-link-01", "status": "pass", "value": 0.0, "threshold": 1e-4, "window": "300s" },

{ "id": "C60-arr-71", "status": "pass", "value": 0.0, "threshold": 1e-9, "window": "300s" }

],

​

"slo": {

"window": "86400s",

"targets": { "offset_p99_s": 1e-6, "latency_p99_s": 0.05 },

"burn_rate": 0.12

},

​

"audit": {

"events": [ "EVT.BUILD", "EVT.CONTRACT_OK", "EVT.SIGN" ],

"hash": "sha256:xxxxxxxx",

"signature": "-----BEGIN SIGNATURE-----...-----END SIGNATURE-----"

}

}

VII. 样例（小规模站点，PTP+SyncE，5 分钟窗口）

{

"schema_ver": "sync.manifest/1.0.0",

"TraceID": "trace-2025-09-01-0007",

"release": { "tag": "r20250901.1", "ts": "2025-09-01T08:00:00Z" },

​

"id": { "rid": "run-7f1a", "pid": "pipe-sync-a1", "pk": "sync:siteA:clk0" },

​

"timebase": {

"tau_mono": { "ref": "clk://rb-1pps", "window": "300s" },

"offset": { "unit": "s", "p50": 2.1e-7, "p95": 6.3e-7, "p99": 8.7e-7, "mean": 2.4e-7, "std": 1.9e-7 },

"skew": { "unit": "s/s", "p50": 1.2e-9, "p95": 2.6e-9, "p99": 3.9e-9 },

"J": { "unit": "s", "rms": 1.8e-7, "pp": 8.9e-7 }

},

​

"protocol": {

"mode": ["PTP","SyncE"],

"ptp": { "profile": "G.8275.1", "domain": 24, "ann_interval": 1, "ts_source": "hw" },

"synce": { "esmc": "Q-L-PRS", "prio": 4 }

},

​

"link": {

"media": "fiber",

"pdv": { "unit": "s", "p95": 4.2e-5, "p99": 7.9e-5 },

"asym": { "unit": "s", "estimate": 4.0e-7, "method": "calibrated" }

},

​

"arrival": {

"gamma": "path://siteA->siteB",

"c_ref": 299792458.0,

"T_arr": {

"form1": 3.347e-3,

"form2": 3.3470000007e-3,

"delta_form": 7.0e-10,

"unit": "s",

"tol_Tarr": 1.0e-9

}

},

​

"servo": { "type": "PLL", "bw_hz": 0.2, "damping": 0.75, "t_lock": 11.6 },

​

"metrics": {

"latency": { "unit": "s", "p99": 0.041 },

"offset": { "unit": "s", "p50": 2.1e-7, "p95": 6.3e-7, "p99": 8.7e-7 },

"skew": { "unit": "s/s", "p50": 1.2e-9, "p95": 2.6e-9, "p99": 3.9e-9 },

"jitter": { "unit": "s", "rms": 1.8e-7, "pp": 8.9e-7 },

"allan": { "adev": [ { "tau": 1.0, "value": 3.0e-11 }, { "tau": 10.0, "value": 9.5e-12 } ] },

"hdev": { "hdev": [ { "tau": 100.0, "value": 3.2e-12 } ] }

},

​

"topology": { "gm": { "id": "gm-PRTC-01", "class": "G8272.1" }, "bc_layers": 2, "redundancy": 2 },

​

"contracts": [

{ "id": "C60-sync-31", "status": "pass", "value": 8.7e-7, "threshold": 1e-6, "window": "300s" },

{ "id": "C60-link-01", "status": "pass", "value": 7.9e-5, "threshold": 1e-4, "window": "300s" },

{ "id": "C60-arr-71", "status": "pass", "value": 7.0e-10, "threshold": 1e-9, "window": "300s" }

],

​

"slo": { "window": "86400s", "targets": { "offset_p99_s": 1e-6, "latency_p99_s": 0.05 }, "burn_rate": 0.08 },

​

"audit": {

"events": [ "EVT.BUILD", "EVT.CONTRACT_OK", "EVT.SIGN" ],

"hash": "sha256:5a1b...be21",

"signature": "-----BEGIN SIGNATURE-----MEUCIQ...-----END SIGNATURE-----"

}

}

VIII. 校验与生成流程（对接 I60-**）

• 生成：emit_sync_manifest(metrics, contracts, cfg) -> manifest.sync。
• 量纲：repair_units(manifest.sync) -> check_dim(all)，失败即阻断发布。
• 契约：evaluate_contracts(manifest.sync, rules=C60-*) -> report。
• 签名：freeze_release(manifest.sync, tag) -> {hash_sha256, signature}。

IX. 交叉引用

• 时基映射与到达时两口径：见《EFT.WP.Metrology.TimeBase v1.0》第9章与附录。
• 契约库与策略卡：见本卷《附录B》。
• 发布闸门与审计规范：见《EFT.WP.Methods.Cleaning v1.0》第10章。