50-参数注册卡 Template v1.0 | 第12章 附录（表单/清单/模板）

目录 ／ 文档-技术白皮书 ／ 50-参数注册卡 Template v1.0

第12章 附录（表单/清单/模板）

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

• 汇集参数注册全流程的表单、清单、机读模板与发布骨架，与第 3–11 章口径一致；引用采用“卷名 + 版本 + 锚点（P/S/M/I）”。
• 涉及路径量（到达时/相位）时，正文显式 gamma(ell) 与测度 d ell，并在卡片数据侧记录 delta_form ∈ {general, factored}；对外发布要求 p_dim = 1.0。

II. 附录目录索引（Index）
A. 单卡模板 param_card.yaml / 注册表 param_registry.csv / 模式 params_schema.json
B. 路径块模板 path_block.yaml（gamma/measure/delta_form）
C. 协方差组与跨组配置 cov_groups.yaml
D. 质量门规则 gate_rules.yaml / 校验响应样例 validate_response.json
E. 审计与发布清单 audit.jsonl / report_manifest.yaml
F. OpenAPI 片段 openapi.yaml（Schema 与 API）
G. 一页式发布目录结构与自检清单

III. 单卡模板（Param Card，YAML）

version: "1.0.0"

param_id: "CAL-01-τ_sys"

name: "system_delay"

symbol: "τ_sys"

domain:

type: "real"

unit: "s"

range: [0, 1e-3]

default: 1.0e-6

precision: "float64"

lineage:

source_type: "measured" # measured|derived|configured

method: "loopback"

instrument: "DPO-7k"

calib_run_id: "CAL2025-09-24-01"

freshness:

valid_from: "2025-09-24T00:00:00Z"

valid_to: "2025-10-24T00:00:00Z"

policy: { tau_calib_s_max: 86400, clock_state: "locked" }

uncertainty:

type: "A"

estimate: 2.0e-8

distribution: "normal"

coverage: { k: 2 }

cov_group: "timing"

constraints:

depends_on: ["ENV-02-ΔT"]

derived: ""

status: "stable" # draft|stable|deprecated

see:

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

references: []

注册表（CSV 表头）

param_id,name,symbol,domain.type,domain.unit,domain.range_min,domain.range_max,domain.default,precision,cov_group,status,version

params_schema.json（节选）

{

"$schema":"https://json-schema.org/draft/2020-12/schema",

"title":"param_card v1.0.0",

"type":"object",

"required":["param_id","symbol","domain","status","version","see"],

"properties":{

"param_id":{"type":"string","pattern":"^[A-Z]{3}-\\d{2}(-[A-Za-z_]{1,16})?$"},

"symbol":{"type":"string"},

"domain":{"type":"object","required":["type","unit"]},

"lineage":{"type":"object"},

"freshness":{"type":"object"},

"uncertainty":{"type":"object"},

"cov_group":{"type":"string"},

"constraints":{"type":"object"},

"path":{"type":"object"},

"status":{"enum":["draft","stable","deprecated"]},

"see":{"type":"array","items":{"type":"string"},"minItems":1},

"version":{"type":"string"}

}

}

IV. 路径块模板（Path Block）

path:

gamma: "gamma(ell)" # 显式路径

measure: "d ell" # 显式测度

delta_form: "general" # general|factored

meta:

delta_ell: 0.25 # 采样步长（m），示例

notes: "Show gamma/measure in text; record delta_form in card."

V. 协方差组配置（Cov Groups）

version: "1.0.0"

cov_groups:

timing:

kernel: "ar1" # exp|matern|ar1|const

params: { sigma2: 4.0e-16, phi: 0.85 }

medium:

kernel: "exp"

params: { sigma2: 9.0e-6, L_c_m: 25.0 }

cross_covar:

- pair: ["medium","env"]

rule: "const_rho"

params: { rho: 0.25 }

VI. 质量门与校验（Gates & Validate）
gate_rules.yaml

version: "1.0.0"

gates:

G1: { schema_required: ["param_id","symbol","domain","status","version","see"] }

G2: { anchor_coverage_min: 0.90, forbid_external_links: true }

G3: { path_required: true, min_samples: 2, delta_form: ["general","factored"] }

G4: { require_dim_check: true, p_dim: 1.0 }

G5: { tau_calib_s_max: 86400, clock_state: "locked" }

G6: { require_uncertainty: true, coverage_allowed: ["k","alpha","quantile"] }

G7: { cov_pd: true, kernel_allowed: ["exp","matern","ar1","const"] }

G8: { unique_param_id: true, unique_checksum: true, lineage_acyclic: true }

stops:

S1: "dim_check_fail or p_dim<1"

S2: "freshness_expired or clock_state!=locked"

S3: "path_block_missing"

S4: "covariance_not_pd or cov_model_mismatch"

S5: "anchor_coverage_below_min or external_link_found"

labels: { restricted: "[Restricted]" }

validate_response.json

{

"param_id":"PHY-03-n_eff_profile",

"version":"1.0.0",

"gates":{"G1":true,"G2":0.94,"G3":true,"G4":true,"G5":true,"G6":true,"G7":true,"G8":true},

"stops_triggered":[]

}

VII. 审计与发布（Audit & Release）
audit.jsonl（示例行）

{"ts":"2025-09-24T16:10:00Z","event":"locked","param_id":"CAL-01-τ_sys",

"version":"1.1.0","user":"release-bot","input_hashes":["sha256:..."],

"notes":"lock for release","signature":"PGP:...","checksum":"sha256:..."}

report_manifest.yaml

version: "1.0.0"

bundle:

cards: ["cards/param_card.yaml"]

tables: ["tables/param_registry.csv"]

reports: ["reports/check_dim_report.json","reports/audit.jsonl"]

figures: []

metadata:

dataset_id: "ptn-demo"

method_version: "2.0.0"

checksums: ["sha256:..."]

see:

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

VIII. OpenAPI 片段（Schema 与 API）

openapi: 3.0.3

info: { title: "Param Registry API", version: "1.0.0" }

servers: [{ url: "https://registry.example.com/api/v1" }]

paths:

/params: { get: { summary: "List cards" }, post: { summary: "Register/Update card" } }

/params/{param_id}: { get: { summary: "Get card" } }

/params/{param_id}/validate: { post: { summary: "Validate gates & schema" } }

/params/{param_id}/lock: { post: { summary: "Lock version" } }

components:

schemas:

ParamCard: { $ref: "#/components/schemas/ParamCard" }

IX. 发布目录结构（Recommended Layout）

PTN_EXPORT/

cards/

param_card.yaml

tables/

param_registry.csv

reports/

check_dim_report.json

audit.jsonl

schemas/

params_schema.json

configs/

gate_rules.yaml

cov_groups.yaml

report_manifest.yaml

SIGNATURE.asc

X. 一页式发布自检清单（Publish Checklist）

• 文内与数据 see[]/references[] 采用“卷名+版本+锚点”，锚点直指率 ≥ 90%，无外链/别名。
• 路径量显式 gamma(ell)、d ell；卡片记录 delta_form；len(path) ≥ 2、Δell 合规，p_dim = 1.0。
• param_card.yaml/json、param_registry.csv、params_schema.json、audit.jsonl、report_manifest.yaml 与签名齐备。
• gate_rules.yaml 与 /validate 报告一致；锁版本已执行（如适用）。
• cov_group/cov_model 与误差预算卡一致；覆盖口径与发布表一致。
• 目录结构按规范分类，无裸散文件；所有制品均有 checksum。