51-管线卡 Template v1.0 | 第12章 产出与发布（目录/可视化/对比评分）

目录 ／ 文档-技术白皮书 ／ 51-管线卡 Template v1.0

第12章 产出与发布（目录/可视化/对比评分）

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

• 统一管线产出物的目录结构、可视化与表格以及对比评分（相对基线/版本对照）的生成与发布口径，确保跨团队交付的可审计、可复现与可比对。
• 涉及路径量（到达时/相位）之产出，正文显式 gamma(ell) 与测度 d ell，数据侧记录 delta_form ∈ {general, factored}；发布要求 p_dim = 1.0。

II. 前置条件与输入（Prerequisites & Inputs）

• 校验前置：/validate 通过 G1–G8 且无 S1–S5 触发；check_dim_report.json 通过（p_dim = 1.0）。
• 契约一致：stage.yaml、contract.yaml/schema.json、参数卡/误差卡（cov_group/coverage）与本卷配置一致。
• 时基与同步：第5章阈值满足（clock_state="locked"、σ_y(τ)、|δt_abs|/|Δτ_ch| 在限内）。
• 路径一致：len(gamma_ell)=len(d_ell)=len(n_eff)≥2，Δell 合规；相位计算对齐参考窗。

III. 产出目录（Artifacts & Directory）

1. 必交付：
   • 图表：DAG/状态、时基与同步健康、路径剖面与区间、性能（延迟/吞吐/资源）、对比评分。
   • 表格：合规模块（G1–G8）、关键指标与区间、对比评分明细、入/出站契约快照。
   • 报告：check_dim_report.json、validate_report.json、perf_summary.md、audit.jsonl、report_manifest.yaml、签名 SIGNATURE.asc。
2. 单位与量纲：所有数值型产出显式单位；含除号/积分/复合算符必须加括号。

推荐目录结构

PTN_EXPORT/

figs/

pipeline_dag.svg

state_timeline.pdf

sync_health.pdf

path_profile.pdf

latency_hist.pdf

throughput_series.svg

scorecard_bar.pdf

tables/

kpi_summary.csv

compliance_table.csv

scorecard.csv

contracts_snapshot.csv

reports/

check_dim_report.json

validate_report.json

perf_summary.md

audit.jsonl

manifests/

report_manifest.yaml

SIGNATURE.asc

IV. 可视化规范（Visualization Standards）

1. 格式：每张图双份导出（矢量 PDF/SVG 与位图 PNG/JPG），DPI ≥ 300；坐标轴显式单位（s, rad, 1, m/s, MB/s 等）。
2. 图注：包含 see[]/version，路径图注标注 Δell 与 delta_form。
3. 最小图集：
   • DAG/状态：pipeline_dag.svg、state_timeline.pdf。
   • 同步健康：sync_health.pdf（δt_abs/Δτ_ch/σ_y(τ) 时序+阈值线）。
   • 路径剖面：path_profile.pdf（n_eff(ell) 与 T_arr/Phi 区间带）。
   • 性能：latency_hist.pdf、throughput_series.svg、resource_util.pdf。
   • 评分：scorecard_bar.pdf（相对基线的加权总分与分项）。

V. 对比评分（Comparative Scoring）

1. 指标与映射：
   • 主指标：ΔT_arr (s)、r_phi (1)、ε_flux (1)、p_dim (1)、Q_res (1)。
   • 规范化：z_m = ( m − m_baseline ) / σ_baseline。
   • 记分：q_m = 1 / ( 1 + exp( a z_m + b ) )（默认 a=1,b=0；必要时方向取反）。
   • 总分：Q = ( ∑_i w_i q_{m_i} ) / ( ∑_i w_i )。
2. 判定门槛（与第9/10章对齐）：
   • 阳性：核心门通过（|ΔT_arr| + U(T_arr) ≤ τ_T、LB(r_phi) ≥ r_phi_min、p_dim = 1.0、P95(ε_flux) ≤ guard），且 Q ≥ Q_base + δQ_min。
   • 否则：阴性/限制模式 [Restricted]。
3. 发布表：在 scorecard.csv 与 scorecard.json 中同步记录计算口径、权重 w_i、区间与阈值对照。

VI. 合规模块（Compliance Block）

• 展示：p_dim、anchor_coverage/ver_presence、clock_state/τ_calib、覆盖口径（k/alpha/quantile）、协方差 PD 检查、G1–G8 通过率与 stops_triggered。
• 任一核心门失败，图表与表格统一加 [Restricted] 标签，仅发布定性趋势与诊断图。

VII. 机读配置（Machine-Readable Configs）
A. report_manifest.yaml

version: "1.0.0"

bundle:

figs:

- "figs/pipeline_dag.svg"

- "figs/state_timeline.pdf"

- "figs/sync_health.pdf"

- "figs/path_profile.pdf"

- "figs/latency_hist.pdf"

- "figs/throughput_series.svg"

- "figs/scorecard_bar.pdf"

tables:

- "tables/kpi_summary.csv"

- "tables/compliance_table.csv"

- "tables/scorecard.csv"

- "tables/contracts_snapshot.csv"

reports:

- "reports/check_dim_report.json"

- "reports/validate_report.json"

- "reports/perf_summary.md"

- "reports/audit.jsonl"

metadata:

pipeline_id: "ptn-core"

method_version: "2.0.0"

created_at: "2025-09-24T16:00:00Z"

checksums: ["sha256:..."]

see:

- "EFT.WP.Core.Equations v1.1:S20-1"

- "EFT.WP.Core.Metrology v1.0:check_dim"

B. scorecard.json（示例）

{

"version": "1.0.0",

"baseline": { "id": "base-001", "Q": 0.62 },

"method": { "id": "pipeline-A", "Q": 0.78 },

"weights": { "DeltaT_arr_s": 0.35, "r_phi": 0.25, "epsilon_flux": 0.15, "p_dim": 0.15, "Q_res": 0.10 },

"metrics": {

"DeltaT_arr_s": { "mean": -2.3e-9, "std": 4.8e-9, "U_k2": 1.5e-9 },

"r_phi": { "value": 0.72, "lb95": 0.61, "ub95": 0.80 },

"epsilon_flux": { "median": 0.004, "p95": 0.011 },

"p_dim": 1.0,

"Q_res": 0.13

},

"decision": "pass",

"see": ["EFT.WP.Core.Equations v1.1:S20-1","Data.Benchmarks v1.0:PROTO"]

}

C. kpi_summary.csv（表头）

stage,latency_p50_s,latency_p95_s,throughput_rps,rho_util,q_res,p_dim,epsilon_flux,allan_1s

ingest,0.032,0.085,1200,0.68,0.14,1.0,.,1.1e-11

arrival,0.047,0.110,950,0.72,0.13,1.0,0.006,1.2e-11

VIII. 反例与修正（Anti-Patterns & Fixes）

• 反例：仅报均值无区间 → 修正：补充 U = k·u_c 或分位带，并注明覆盖口径。
• 反例：路径图未标 delta_form/Δell → 修正：在图注补全并与 n_eff 对齐。
• 反例：T_arr = ∫ n_eff / c_ref d ell（缺括号）→ 修正：T_arr = ( ∫ ( n_eff / c_ref ) d ell )。
• 反例：未附 check_dim_report.json 即发布 → 修正：先校核 p_dim = 1.0 再放行。

IX. 校验与发布流程（Validation & Release Flow）

• 生成与核验：跑完 /validate、check_dim_report.json、性能与评分表格与图表。
• 归档与签名：产出物写入 PTN_EXPORT/ 并生成 report_manifest.yaml 与 SIGNATURE.asc。
• 审计与锁版：audit.jsonl 记录版本与校验和；按需执行版本锁定与回滚点。
• 对外发布：仅允许 v1.* 引用；锚点直指率 ≥ 90%；不合规项标注 [Restricted]。

X. 交叉引用（Cross-References）

• 体系结构与计算图（第3章）；阶段规格（第6章）；资源与性能（第8章）；质量门与监控（第9章）；UQ 耦合与闭环（第10章）。
• 参数注册卡：数据契约与接口（相应章节）；误差预算卡：评分口径与阈值映射（Ch.8/Ch.9）。

XI. 执行勾选清单（Checklist）

• 图表双份导出（PDF/SVG 与 PNG）；轴单位与图注 see[]/version 完整；路径图注明 Δell 与 delta_form。
• scorecard.csv/json 与基线/阈值对照一致；权重、区间与决策透明。
• compliance_table.csv、kpi_summary.csv、contracts_snapshot.csv 已生成且单位/量纲齐全。
• check_dim_report.json、validate_report.json、perf_summary.md、audit.jsonl、report_manifest.yaml 与签名齐备。
• /validate 通过且无 S1–S5；若限制模式，所有产出均加 [Restricted] 标签并仅给定性说明。
• 引用合规（卷名+版本+锚点，直指率 ≥ 90%），无外链/别名；版本与工件校验和一致。