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

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

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

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

I. 范围与对象

II. 命名与版本

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）

VI. 字段校验与拒绝准则

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

JSON 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": 1.55e-06,
      "k_sub_set": [ 0, 1, 2 ],
      "S_sel": [ "core1" ],
      "B_eff": 50000000000.0,
      "unit(B_eff)": "Hz",
      "dim(B_eff)": "[1/T]"
    }
  },
  "phys": {
    "gamma.hash": "sha256:gamma...",
    "T_arr_forms": {
      "form1": 0.002315,
      "form2": 0.002316,
      "delta_form": 1e-06,
      "tol": 2.3e-06,
      "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": 12500000000.0,
    "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": 0.0018
  },
  "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-09,
      "ΔT_med": 4e-10,
      "ΔT_inst": 2.1e-09,
      "ΔT_proc": 8e-10,
      "ΔT_sync": -3e-10,
      "unit": "s",
      "dim": "[T]"
    },
    "T_arr_star": 0.002316004,
    "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-06,
    "FM_dB": 3.5,
    "two_form": {
      "pred": { "lat_total": 0.00028 },
      "meas": { "lat_total": 0.00029 },
      "delta_form": 1e-05,
      "tol": 1.5e-05,
      "unit(lat_total)": "s",
      "dim(lat_total)": "[T]"
    }
  },
  "queue": {
    "model": { "type": "M/M/1", "λ": 8500000.0, "E[L]": 12000, "C": 480000000000.0 },
    "lat": { "config": 0.00013, "meas": 0.00014, "unit": "s", "dim": "[T]" },
    "delta_form_queue": 1e-05,
    "tol": 2e-05
  },
  "meas": {
    "B": 50000000000.0,
    "RBW": 12500000000.0,
    "OSNR": { "meas_dB": 24.7, "pred_dB": 25.1 },
    "EVM": { "meas": 0.034, "pred": 0.031 },
    "BER": { "meas": 0.00012, "pred": 9.5e-05 },
    "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": 0.0002,
      "latency_p95": 0.00029,
      "latency_p99": 0.00032,
      "drop_rate": 2e-05,
      "ρ": 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-07, "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）

规范化步骤：

IX. 交叉引用

X. 小结

版权与许可（CC BY 4.0）

版权声明：除另有说明外，《能量丝理论》（含文本、图表、插图、符号与公式）的著作权由作者（“屠广林”先生）享有。
许可方式：本作品采用 Creative Commons 署名 4.0 国际许可协议（CC BY 4.0）进行许可；在注明作者与来源的前提下，允许为商业或非商业目的进行复制、转载、节选、改编与再分发。
署名格式（建议）：作者：“屠广林”；作品：《能量丝理论》；来源：energyfilament.org；许可证：CC BY 4.0。

首次发布： 2025-11-11｜当前版本：v5.1
协议链接：https://creativecommons.org/licenses/by/4.0/