接口命名从信号语义出发
接口命名应先回答“这根线或这个字段传递什么”，再回答“接头长什么样”。GR-Edge 的设计文档可以把目标磁通道、参考通道、时间源、供电和维护通路分组，但不能凭一张概念图宣布设备已经具有某类工业总线、某个防护等级或已验收的电气针脚。
从采样线束到事件报告
接口在现场往往经历三次“翻译”：探头接线被标记为采集通道，采集样本附上时间，软件再按窗口组织成一份解释报告。若这三步复用含混名称，例如把“信号一”用于目标轴又用于参考探头，维护人员可能把失联或干扰误认为车辆事件。
约定名称时必须有方向与来源：例如设计层写“目标测量输入”和“参考测量输入”，而不把 reference 定义成已证实的“噪声真值”。参考探头只是另一个观测位置，它会受到不同的近场源影响，其价值依赖布设和同步。
十五列CSV与物理端口的界限
现成 数据一行包含十五列：scenario_id、sample_index、time_s、四路数值、四路状态、timebase_status、unit、synthetic、data_version。字段集合已经在 field_dictionary.json 冻结，页面不新增硬件地址、通信协议或者种子列来假装它们在 CSV 中。
如果接口名称要映射到 GR-Edge 将来的物理端口，建议另建“逻辑信号→插座位号→导线编号→固件通道”的受控映射表，并以版本号管理。接口文档变更时先比对数据字典，再更新图纸；有不确定项时显式留空，不以某厂商连接器规格代替项目实测。
分析模块接口与异常状态
异常状态也是接口的一部分。reference_status 为 LOST 时对应值必须为空并使曲线断开；SATURATED 仍可能保留截顶显示值，但不能用于正常峰幅推断。timebase_status 标记时间基准状态，不能因绘图平滑而抹掉。
| 层级 | 实际或拟议名称 | 不可混淆的含义 |
|---|---|---|
| 实际CSV | reference_au / reference_status | 数值与质量两条独立信息 |
| 实际报告 | decision.status / reasons | 合成规则判定而非故障代码 |
| 拟议硬件 | 目标输入 / 参考输入 / 时间源 | 尚无锁定针脚与电气规格 |
测量位置与OPM读出链
车库磁源示意解释不同通道会受到哪些空间场源影响，原子自旋图说明磁测元件的基本读出原理。接口名称与接线应以文字和实际工程定义为准，原理图不能替代GR-Edge板卡引脚图。
为了核对真实软件路径，可查看 [十二案数据入口](/gaterestart/simulations/) 与 [GR-Edge 模块说明](/gaterestart/products/gr-edge/)；SIM-12 参考失联演示说明为什么状态字段必须独立于数值字段。
软件字段、硬件规划与科学依据
在近零场型磁测系统中，补偿电路与传感器工作点有关；但文献中的补偿线圈结构不是 GR-Edge 已存在的端口定义。本篇只说明保持测量、质量与控制接口边界的重要性，不为虚构硬件发布电气参数。
版本化映射表和延伸阅读
下一次接口审查应对每个名称回答四个问题：谁生成、什么单位、何时有效、失败时如何编码。通过这四问才能决定接线标签、日志键名和图表图例是否一致；否则一个好看的“接口总览”只会隐藏数据耦合错误。
详细的数据浏览流程见 [研究资料馆](/gaterestart/research/)；产品设计版式见 [GR-01](/gaterestart/products/gr-01/)；常规更新见 [项目动态](/gaterestart/updates/)。