目录 / 文档-技术白皮书 / 51-管线卡 Template v1.0
I. 适用范围(Scope of Use)
- 管线类型:批处理(Batch)、流式(Streaming)、近实时(Near-RT)、混合(Hybrid)。
- 工作域约束:近轴小角、缓变介质与相干窗 T_coh/L_coh/B_coh 成立;涉及路径量(到达时/相位)须在正文显式 gamma(ell) 与测度 d ell,并在数据侧记录 delta_form ∈ {general, factored};发布要求 p_dim = 1.0。
- 数据对象:入/出站契约对齐 TARR;参数/误差/实验协议的引用一律“卷名 + 版本 + 锚点(P/S/M/I)”。
- 适配场景:端到端建模/推理/计量闭环(含回放与再标定);跨团队交付与对比评分。
II. 场景矩阵(Pipeline Scenarios Matrix)
场景 | 典型输入 | 关键阶段 | 主要指标 | 适用门 | 说明 |
|---|---|---|---|---|---|
Batch | 分区文件/对象存储 | 特征抽取→拟合→汇总 | P50/P95 延迟、吞吐、Q_res | G1/G4/G6/G8 | 版本化入站 Schema |
Streaming | 事件/消息队列 | 清洗→聚合→实时估计 | 时延抖动、丢失率、σ_y(τ) | G3/G5/G6 | Exactly-Once/At-Least-Once |
Near-RT | 共享内存/微批 | 同步→路径积分→相位对齐 | T_arr、r_phi、ε_flux | G3/G4/G7 | 显式 gamma(ell)/d ell |
Hybrid | 线上+离线 | 线上推理↔离线校准 | SLA/SLO、成本、p_dim | G1–G8 | 回放与再标定闭环 |
III. 依赖清单(Dependencies)
- Core(必备):EFT.WP.Core.Terms v1.0、EFT.WP.Core.Equations v1.1、EFT.WP.Core.Metrology v1.0、EFT.WP.Core.DataSpec v1.0。
到达时与相位统一口径:
T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell );T_arr = ( ∫ ( n_eff / c_ref ) d ell );
Phi = ( 2π / λ_ref ) * ( ∫ n_eff d ell )。 - Templates(配套):PTN Template v1.0(Ch.5/Ch.11)、参数注册卡 Template v1.0(Ch.3/Ch.9)、误差预算卡 Template v1.0(Ch.5/Ch.6/Ch.8/Ch.9)、实验协议卡 Template v1.0(Ch.5/Ch.11)。
- 运行与计量:Metrology.TimeBase v1.0、Metrology.Sync v1.0、Metrology.Instrument v1.0、Metrology.PathCorrection v1.0、Methods.Repro v1.0。
IV. 引用与版本(Citations & Versioning)
- 固定写法:见《<卷名> vX.Y》<章节> <锚点>;优先 P/S/M/I;锚点直指率 ≥ 90%,禁止外链/别名。
- 版本策略:对外仅 v1.*;若引用 v0.* 必在文内标注“草案/非承诺”。
- 依赖闭合:跨卡跨卷引用须在 see[]/references[] 与制品清单(manifest)中同步。
V. 合规前置(Compliance Prerequisites)
- 量纲闭合:I70-dim_check 通过并随附 check_dim_report.json;p_dim = 1.0。
- 同步新鲜度:clock_state="locked",|ts_start − calib.timestamp| ≤ τ_calib。
- 路径一致性:len(gamma_ell)=len(d_ell)=len(n_eff)≥2,Δell 满足采样约束;路径/测度缺失即拒收。
- 参数对齐:所用参数均已在“参数注册卡”注册并通过参数级质量门(G1–G8)。
VI. 质量门映射(Gate Mapping,管线级)
- G1 Schema 完整|G2 引用合规|G3 路径规范|G4 量纲闭合|G5 新鲜度|G6 覆盖口径|G7 协方差一致|G8 唯一性。
- 触发 S1–S5(量纲失败/新鲜度失效/路径缺失/协方差失配/引用不合规)即阻断阶段执行与发布;必要时进入 [Restricted]。
VII. 产出与接口(Outputs & Interfaces)
- 制品:pipeline_graph.json、stage.yaml、param_registry.csv、check_dim_report.json、audit.jsonl、图表(DAG/性能/路径剖面)、report_manifest.yaml。
- 接口:
- I60-stage_exec(ctx, x) -> y | err
- I61-validate_gate(card, gates[]) -> report.json
- I62-export_artifacts(fmt) -> {manifest, checksums}
- 安全:最小权限访问;写入端点记录审计事件 created|updated|validated|locked。
VIII. 执行勾选清单(Checklist)
- 场景与依赖已确认;see[]/references[] 合规并锚点直指率 ≥ 90%。
- 对路径量的阶段:正文显式 gamma(ell)、d ell;数据侧已记录 delta_form。
- I70-dim_check 通过且 p_dim = 1.0;clock_state="locked"、τ_calib 合规。
- 参数与误差卡就绪(域/单位/覆盖/cov_group 一致);协方差与 UQ 配置与误差预算卡对齐。
- /validate 通过 G1–G8;发布包含 report_manifest.yaml、audit.jsonl 与签名。
版权与许可(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/