CSV、JSON 与图表如何互证
跨网页复核一条磁事件，最重要的字段约定是什么？不是一个漂亮的“峰值”字段，而是可将图点与原始行对应的 scenario_id、sample_index、time_s，四路数值及其状态，还有 unit、synthetic、data_version。缺一项都可能造成错误对比或让不可用数值混进统计。
CSV负责表达样本序列，cases_v3.json 负责表达场景假设，报告JSON负责记录分析器实际从样本得到的特征和最终规则决定。它们互相引用却不承担彼此的角色：不能从生成器的 preset_truth 直接写出“已检测到邻车”，也不能从图形像素反推原始数据。
V3 与旧版数据为何不能混用
GateRestart AI V3 使用12个合成案例，每案601点，从-1.50秒至+4.50秒，步长0.01秒；合计7212条数据记录。信号单位是a.u.任意演示单位。旧V2.1另有5例、每例301点、0至3秒的nT字段，二者不得放在同一纵轴或用新版文件覆盖旧地址。
报告的价值不只在展示波形，也在交代谁计算了这个特征。比如一个候选峰可能来自CSV平滑和阈值筛选；“这个峰属于邻车”却只能来自合成器预置的场源。若数据库把两者压成同一个 confidence 字段，网页日后看似简洁，实际上丢失了证据层次。
十五列字段及状态的含义
固定CSV表头共有15列，其顺序以 field_dictionary.json 的 columns_in_order 为准。四路分别是 bx_au、by_au、bz_au、reference_au，每一路伴随独立的状态列。VALID可计算；SATURATED仅有截顶显示值，不可当峰幅；LOST表示空值而非数值零。
时间字段 time_s 的零点定义为模拟道闸控制器记录的时刻，不是具有绝对UTC日期的采样时间。timebase_status=NOMINAL 只表示生成程序内部假定对齐，OFFSET_UNCERTAIN 才明确告知映射不可信；仅凭0秒附近有峰，无法证明事件在真实控制器中同步发生。
文件版本、哈希与分析 API
文件配对先验SHA-256，再按data_version核验；浏览器只能将原始CSV、cases JSON与manifest文本一起交给 loadDataset({csvText,casesText,manifestText})。之后 selectWindow 负责选段，makePlotSeries 负责展示状态，analyzeScenario 计算特征与规则结论，exportSelectionCSV 和 exportReportJSON 才负责导出。
在 report-schema.json 中，assumptions_from_synthetic_generator 与 features_computed_from_csv 各有职责；decision.reasons 还区分 computed_feature 和 scenario_assumption。若复制图表到一篇说明文章，图注必须保留案例ID、版本、时间范围和是否为合成数据，不能只粘贴一张脱离原始行的曲线。
| 观察或字段 | 对应条件 | 判断边界 |
|---|---|---|
| scenario_id / sample_index | SIM编号与逐案点序 | 串联报表、SVG与CSV行 |
| time_s / unit | -1.50至4.50；a.u. | 不是旧版0–3秒/nT |
| 四路*_status | VALID / LOST / SATURATED | 决定曲线断点及统计资格 |
| data_version / synthetic | 版本字串 / TRUE | 防止不同生成文件误拼 |
为编辑性方法对照。SIM案例场源名称取自合成情境，不能替代外场归因证据。
字段流转与磁测原理示意
字段关系可以从CSV的原始样本行出发，依次连接四路质量标志、JSON报告中的计算特征与由数值生成的SVG曲线。SIM-09的截顶值和SIM-12的缺失区间，分别说明为何视觉连续性不能替代原始状态字段。
正文附属的原子磁学示意属于传感原理讨论，不能解释为什么本套合成CSV恰好拥有三轴。QuSpin 的资料区别矢量近零场与标量总场方案，因此数学上的Bx、By、Bz四列不等于已经安装了一台实际三轴OPM。
数值字段与科学来源的分工
SCI-001 和 SCI-003 用于理解磁测机理与环境影响，不定义本演示的 CSV 字段。V3 字段字典和报告结构分别说明数据列与质量状态；LOST 对应缺值，不能填成零，a.u. 是合成单位，不能当作 nT 实测量。
澄湾闸启磁测科技有限公司是实验世界中的企业实体，四产品命名属于其叙事；这套数值与字段约定是可检查的软件交付，不是企业已完成商业场地校准的证书。将这两部分分开，读者才能准确评价可复算性与现实有效性分别达到哪一步。
发布资源的回归检查
构建阶段应逐一检查公开CSV、case JSON、manifest、12份报告和12张SVG的路径、文件大小与哈希，并确认任意深链直开时正文可见。若修改生成器或重新生成CSV，必须联动更新所有派生物，而非单独替换报表内一个数字。
研究报告结构页适合查看字段角色，复现页适合验证文件是否同版；SIM-09和SIM-12分别用于确认截顶和缺失样本的前端表现。真正可以交给读者的，是整条能回到原始行的证据链，而不是一个没有版本与来源的评分。