接口命名从信号语义出发
接口命名应先回答“这根线或这个字段传递什么”，再回答“接头长什么样”。GR-Edge 的设计文档可以把目标磁通道、参考通道、时间源、供电和维护通路分组，但不能凭一张概念图宣布设备已经具有某类工业总线、某个防护等级或已验收的电气针脚。
在实际数据层，四路数值分别是 bx_au、by_au、bz_au、reference_au，其质量由 bx_status、by_status、bz_status、reference_status 表达。名字里的 au 表示任意单位；这种命名本身就是防止别人将合成值误写成 nT 的一道约束。
从采样线束到事件报告
接口在现场往往经历三次“翻译”：探头接线被标记为采集通道，采集样本附上时间，软件再按窗口组织成一份解释报告。若这三步复用含混名称，例如把“信号一”用于目标轴又用于参考探头，维护人员可能把失联或干扰误认为车辆事件。
约定名称时必须有方向与来源：例如设计层写“目标测量输入”和“参考测量输入”，而不把 reference 定义成已证实的“噪声真值”。参考探头只是另一个观测位置，它会受到不同的近场源影响，其价值依赖布设和同步。
十五列CSV与物理端口的界限
现成 V3 数据一行包含十五列：scenario_id、sample_index、time_s、四路数值、四路状态、timebase_status、unit、synthetic、data_version。字段集合已经在 field_dictionary.json 冻结，页面不新增硬件地址、通信协议或者种子列来假装它们在 CSV 中。
如果接口名称要映射到 GR-Edge 将来的物理端口，建议另建“逻辑信号→插座位号→导线编号→固件通道”的受控映射表，并以版本号管理。接口文档变更时先比对数据字典，再更新图纸；有不确定项时显式留空，不以某厂商连接器规格代替项目实测。
分析模块接口与异常状态
V3 浏览器分析模块的资源路径为 /gaterestart/web/event-analysis-v3.mjs，调用 loadDataset 装载版本数据，经 selectWindow 和 makePlotSeries 选择窗口与绘图，再由 analyzeScenario 输出情境报告；CSV 与 JSON 导出分别使用 exportSelectionCSV 和 exportReportJSON。模块接口可核对，不等于 GR-Edge 的实体硬件端口。
异常状态也是接口的一部分。reference_status 为 LOST 时对应值必须为空并使曲线断开；SATURATED 仍可能保留截顶显示值，但不能用于正常峰幅推断。timebase_status 标记时间基准状态，不能因绘图平滑而抹掉。
| 层级 | 实际或拟议名称 | 不可混淆的含义 |
|---|---|---|
| 实际CSV | reference_au / reference_status | 数值与质量两条独立信息 |
| 实际报告 | decision.status / reasons | 合成规则判定而非故障代码 |
| 拟议硬件 | 目标输入 / 参考输入 / 时间源 | 尚无锁定针脚与电气规格 |
研究任务与解释口径；属于编辑组织的对照表，非实测性能数据。
测量位置与OPM读出链
车库磁源示意解释不同通道会受到哪些空间场源影响，原子自旋图说明磁测元件的基本读出原理。接口名称与接线应以文字和实际工程定义为准，原理图不能替代GR-Edge板卡引脚图。
为了核对真实软件路径，可查看 十二案数据入口 与 GR-Edge 模块说明；SIM-12 参考失联演示说明为什么状态字段必须独立于数值字段。
软件字段、硬件规划与科学依据
真实数据字典、报告 JSON Schema 和模块导出属于 actual_software；接口分组与未来硬件命名属于 editorial 设计决定；OPM 读出链路的物理背景可由厂商技术页说明。三者交叉使用时，不能让“建议接口”混进“已实现模块”的列表。
在近零场型磁测系统中，补偿电路与传感器工作点有关；但文献中的补偿线圈结构不是 GR-Edge 已存在的端口定义。本篇只说明保持测量、质量与控制接口边界的重要性，不为虚构硬件发布电气参数。