27-EFT.WP.Packets.Light v1.0 | 附录C 清单模板与样例（packet manifest）

目录 ／ 文档-技术白皮书（V5.05） ／ 27-EFT.WP.Packets.Light v1.0

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

一句话目标：提供光包从物理→成帧→调制→标签→补偿→FSO→到达时→交换/排队→计量→多径→安全→运行全链路的清单模板与样例，统一两口径（配置/解析 vs 测量/实现）与量纲合规，确保可复现/可审计/可回退。

I. 范围与对象

• 对象：manifest.packet.*（分卷分域清单）与端到端聚合清单 manifest.packet。
• 输入：各章 M60-* 产物与 contracts.*、uncertainty.*、面板与证据 URI。
• 输出：可签名、可回放的 JSON/CBOR 文档；端到端清单含引用各分清单的指针。
• 约束：所有数值字段必须具备 unit(field) 与 dim(field) 并通过 check_dim( y - f(x) )；两口径字段必须包含 delta_form 与容差 tol_*。

II. 命名与版本

• manifest.kind = "EFT.Packets.Light.Manifest"；semver = "1.0.0"；schema_uri 指向本附录版本。
• 分域命名：phys/frame/mod/label/comp/fso/tarr/swrt/queue/meas/mpath/sec/rt 分别对应第2–14章。
• 签名链：对规范化内容（见 VIII）计算 digest 并签名 signature；任何字段变更均形成新版本与新签名。

III. 最小键集（核心域与量纲约束）

1. 顶层必备：TraceID, ts, RefCond.hash, graph.hash|segments[], contracts, uncertainty, artifacts, signature。
2. 两口径统一字段（各域通用）：
   • two_form = {pred|config, meas, delta_form, tol}；
   • unit(field) 与 dim(field)；对数量↔线性换算注明 scale.note。
3. 关键域最小键：
   • phys（第2章）：{gamma.hash, T_arr_forms:{form1,form2,delta_form},"OSNR", beta2, PMD, u/U}
   • frame（第3章）：{frame.hash, t_hat_cnt, t_hat_cont, delta_form_frame, offset/skew/J, R_net}
   • mod（第4章）：{mod, R_c, RBW, EVM_{pred,meas}, BER_{pred,meas}, ACLR/OBB, PAPR, delta_form_mod}
   • label（第5章）：{label=(lambda,k_sub,S_sel), B_eff, S_eff, Iso_ch, XT_pwr, plan_pwr, delta_form_label}
   • comp（第6章）：{H_comp.hash|h_eq.hash, CD_res, PMD_res, NL_res, delta_form_comp}
   • fso（第7章）：{weather.hash, Cn2.hash, A_atm, L_point, σ_I^2, G_ap, P_rx, Avail, delta_form_fso}
   • tarr（第8章）：{T_arr_forms, T_parts:{ΔT_geom,ΔT_med,ΔT_inst,ΔT_proc,ΔT_sync}, T_arr_star, tol_Tarr}
   • swrt（第9章）：{path.hash, Xbar.hash, P_block, P_contention, lat_sw, Iso_link, FM_dB, delta_form_swrt}
   • queue（第10章）：{model:{type,params}, lat^{config,meas}, ρ, P_block/P_cont, T_guard_budget, delta_form_queue}
   • meas（第11章）：{B,RBW, OSNR_{meas,pred}, EVM_{meas,pred}, BER_{meas,pred}, P_{tx,rx}, IL, Q_factor, delta_form_meas, cal.hash}
   • mpath（第12章）：{ĥ.hash, events:[{z_k,R̂_k}], MER_{pred,meas}, MP_res_{fiber,fso}, method, delta_form_mpath}
   • sec（第13章）：{metrics:{E_balance,D_spec,Pol_anom,Timing_anom,ΔQ}, Score, delta_form_sec, actions[]}
   • rt（第14章）：{W,H,lateness,watermark, cache:{ttl,size,policy,hit,stale_ratio}, metrics:{delta_form_rt, latency_p{50,95,99}, drop_rate, ρ}, resources:{cpu_pct,mem_pct,gpu_util}}

IV. 两口径与量纲落盘规则（强制）

1. 两口径字段统一为：
   • two_form.pred|config.value、two_form.meas.value、two_form.delta_form、two_form.tol；
   • 度量单位：例如 unit(T_arr) = "s", dim(T_arr) = "[T]"；unit(OSNR) = "dB", dim= "1"。
2. 样本窗口与测度：window = {type∈{time,event}, span, overlap}；measure = {domain∈{t,f,set}, rbw/bw/|S|}。

V. 清单生成流程（对应第15章 M60-15）

• 汇聚：收集各域 manifest.packet.* 子清单的 URI 与哈希；
• 校核：执行各域 C60-* 契约并汇总 contracts.report；
• 合成：写入 uncertainty（GUM/MC）、two_form.* 汇总与单位/量纲映射；
• 签名：对规范化字段集计算 digest 并签名；
• 发布：写入注册中心，绑定面板卡与 rollback_to。

VI. 字段校验与拒绝准则

• 缺键：缺 TraceID/RefCond.hash/segments|graph.hash/contracts/signature → 拒绝。
• 量纲：任何 check_dim 失败 → 拒绝。
• 两口径：delta_form_* > tol_* → 离线 fail，运行时 degrade；处置记录入 strategy.cards[]。
• 签名：验签失败 → 拒绝。

VII. 模板（可直接落盘为 JSON）

{

"manifest": { "kind": "EFT.Packets.Light.Manifest", "semver": "1.0.0", "schema_uri": "urn:eft:packets.light:schema:1.0.0" },

"TraceID": "uuid-v4",

"ts": "2025-09-02T12:34:56Z",

"RefCond": { "hash": "sha256:refcond...", "tz": "UTC", "samplerate": "100GSa/s" },

​

"core": {

"graph": { "hash": "sha256:graph...", "segments": ["sha256:seg1", "sha256:seg2"] },

"frame": { "hash": "sha256:frame...", "T_sym": 9.86e-12, "unit(T_sym)": "s", "dim(T_sym)": "[T]" },

"label": { "lambda": 1550e-9, "k_sub_set": [0,1,2], "S_sel": ["core1"], "B_eff": 5e10,

"unit(B_eff)": "Hz", "dim(B_eff)": "[1/T]" }

},

​

"phys": {

"gamma.hash": "sha256:gamma...",

"T_arr_forms": { "form1": 2.315e-3, "form2": 2.316e-3, "delta_form": 1.0e-6, "tol": 2.3e-6,

"unit": "s", "dim": "[T]" },

"OSNR_dB": 24.7, "unit(OSNR_dB)": "dB", "dim(OSNR_dB)": "1"

},

​

"mod": {

"mod": "DP-16QAM", "R_c": 0.92, "RBW": 12.5e9,

"two_form": {

"pred": { "EVM": 0.031 }, "meas": { "EVM": 0.034 },

"delta_form": 0.003, "tol": 0.006, "unit(EVM)": "1", "dim(EVM)": "1"

},

"ACLR_dB": 44.0, "OBB": 1.8e-3

},

​

"comp": {

"H_comp.hash": "sha256:h_comp...",

"CD_res": 10.5, "unit(CD_res)": "ps/(nm·km)", "dim(CD_res)": "[T]/([L]·[L])",

"delta_form_comp": 0.011, "tol": 0.02

},

​

"fso": {

"weather.hash": "sha256:wx...", "Cn2.hash": "sha256:cn2...",

"A_atm_dB": 3.2, "L_point_dB": 1.1, "Avail": 0.9994,

"two_form": { "pred": { "P_rx_dBm": -17.8 }, "meas": { "P_rx_dBm": -18.4 }, "delta_form": 0.6, "tol": 1.0 }

},

​

"tarr": {

"T_parts": { "ΔT_geom": 1.2e-9, "ΔT_med": 0.4e-9, "ΔT_inst": 2.1e-9, "ΔT_proc": 0.8e-9, "ΔT_sync": -0.3e-9,

"unit": "s", "dim": "[T]" },

"T_arr_star": 2.316004e-3, "unit(T_arr_star)": "s", "dim(T_arr_star)": "[T]"

},

​

"swrt": {

"path.hash": "sha256:path...", "Xbar.hash": "sha256:xbar...",

"P_block": 0.002, "P_contention": 0.006, "lat_sw": 4.1e-6, "FM_dB": 3.5,

"two_form": { "pred": { "lat_total": 2.8e-4 }, "meas": { "lat_total": 2.9e-4 }, "delta_form": 1.0e-5, "tol": 1.5e-5,

"unit(lat_total)": "s", "dim(lat_total)": "[T]" }

},

​

"queue": {

"model": { "type": "M/M/1", "λ": 8.5e6, "E[L]": 12000, "C": 4.8e11 },

"lat": { "config": 1.3e-4, "meas": 1.4e-4, "unit": "s", "dim": "[T]" },

"delta_form_queue": 1.0e-5, "tol": 2.0e-5

},

​

"meas": {

"B": 5.0e10, "RBW": 12.5e9,

"OSNR": { "meas_dB": 24.7, "pred_dB": 25.1 },

"EVM": { "meas": 0.034, "pred": 0.031 },

"BER": { "meas": 1.2e-4, "pred": 9.5e-5 },

"P_tx_dBm": 0.0, "P_rx_dBm": -18.4,

"delta_form_meas": 0.0038, "tol": 0.006,

"cal.hash": "sha256:cal..."

},

​

"mpath": {

"h_hat.hash": "sha256:hh...", "events": [{ "z": 1234.5, "R": 0.0021 }],

"MER": { "pred": 0.015, "meas": 0.019 }, "MP_res_fiber": 0.06, "MP_res_fso": 0.03,

"delta_form_mpath": 0.004, "tol": 0.01

},

​

"sec": {

"metrics": { "E_balance": 0.004, "D_spec": 0.015, "Pol_anom": 0.03, "Timing_anom": 0.012, "ΔQ": 0.006 },

"Score": 0.18, "delta_form_sec": 0.007, "tol": 0.02,

"actions": ["none"]

},

​

"rt": {

"W": 0.5, "H": 0.25, "lateness": 0.1, "watermark": { "lag": 0.04, "policy": "event-time" },

"cache": { "ttl": 60, "size": 2048, "policy": "lru", "hit": 0.86, "stale_ratio": 0.01 },

"metrics": { "delta_form_rt": 0.004, "latency_p50": 2.0e-4, "latency_p95": 2.9e-4, "latency_p99": 3.2e-4, "drop_rate": 2.0e-5, "ρ": 0.62 },

"resources": { "cpu_pct": 0.61, "mem_pct": 0.47, "gpu_util": 0.38 }

},

​

"contracts": {

"rules": [

{ "rule_id": "C60-201", "pass": true, "evidence_uri": "s3://.../tarr_forms.parq" },

{ "rule_id": "C60-402", "pass": true, "evidence_uri": "s3://.../spectrum.png" }

],

"thresholds_uri": "s3://.../thresholds.toml"

},

​

"uncertainty": {

"method": "MC", "coverage": 0.95, "k": 2.0, "nu_eff": 128,

"U": { "T_arr_star": 3.5e-7, "OSNR_dB": 0.6, "EVM": 0.002 }

},

​

"artifacts": {

"phys": "uri://phys/sha256:...",

"comp": "uri://comp/sha256:...",

"meas": "uri://meas/sha256:...",

"panels": ["uri://panel/osnr", "uri://panel/latency"]

},

​

"audit": {

"parents": ["sha256:prev-manifest..."],

"rollback_to": "sha256:stable-manifest...",

"change_log": "increased T_guard; rebalanced ROADM tilt"

},

​

"signature": {

"algo": "ed25519",

"key_id": "k-ops-2025-07",

"digest": "sha256:manifest-core-digest...",

"sig": "base64:MEQCIK..."

}

}

VIII. 规范化与签名（canonicalize）

• 删除 signature 域；
• 以稳定字段顺序串行化（UTF-8，无多余空白）；
• 所有浮点采用十进制字符串（科学计数法统一）；
• 计算 digest = SHA256(bytes)，用 ed25519/ecdsa-p256 签名；
• 回放时用相同规范化流程验签。

IX. 交叉引用

• 接口：附录A I60-*；
• 契约：附录B C60-*；
• 指标与漂移：附录D；
• 不确定度：附录E；
• 章内：第2–14章 P/S/M/I 产物与字段对应本清单键。

X. 小结

• 本附录提供 manifest.packet 的最小键集、两口径与量纲规则、规范化与签名，并给出可直接落盘的模板与样例；
• 结合各章 M60-*、附录A/B 的接口与契约，工程团队可将光包链路的证据—阈值—结果完整清单化，支撑发布、审计与回放的端到端闭环。