孪生点位绑错同名模型，怎样用稳定 ID 检查映射一对多

glTF节点名称不要求唯一，不能拿“风机”这种name当点位绑定的永久主键。数组索引也可能随重新导出变化。孪生映射应约定稳定构件ID，并检查唯一性、悬空引用和一对多关系；同名合法、同稳定ID重复需要报警，不能让后来的记录悄悄覆盖前一台设备。

环境和证据范围

稳定ID是项目自定义契约，不是glTF默认强制字段。附件用提取后的id字段表示稳定ID，实际模型可约定存入extras.stable_id，但不声称所有导出器都会保留它；若使用其他扩展或外部台账，应按对应规范。没有导入真实模型、访问台账或验证任何平台数据库。

核对顺序

1. 先规定ID的生成方、唯一范围和更新稳定性，再决定存到模型还是外部映射。使用节点数组下标只适合作为当前文件内的引用，不能未经约定就当跨版本设备编号。

2. 导入时分别建立名称列表与稳定ID索引。名称重复可以正常保留，稳定ID重复应拒绝自动绑定并列出所有冲突节点，禁止字典赋值覆盖后只留下一个对象。

3. 遍历点位到构件的每条关系，核对构件ID存在、点位存在且关系符合业务设计。一个点位控制一组构件可以合法，一个构件绑定多个指标也可以合法，不能把多对多一概当重复数据。

4. 模型更新时比较旧ID集合、保留ID与消失ID，对被删除构件的点位生成迁移清单。名字没变不等于身份没变，位置相近也不能证明应自动续绑，需台账负责人确认。

可复算的输入与预期

合成节点fan-1与fan-2都叫“风机”，名称重复但稳定ID唯一；点位p-run同时绑定两台风机，作为合法组绑定。错误数据额外加入另一个fan-1节点，并让p-temp指向fan-404。脚本分别输出重复稳定ID fan-1、悬空fan-404和合法组绑定数量2。

下载与现场记录

下载本题合成输入与预期JSON、离线只读核验脚本和现场空白记录CSV。放在同一目录，用 Python 3 运行 python verify.py，逐项计算或解析后与预期比较，失败会显示差异。

现场字段包括 model_version、node_index、node_name、stable_id、point_id、binding_target、conflict_owner。合成样例保持原样，实测另存并填写型号、版本、证据路径，未采集处留空。本地核验不代表真实设备、代理、浏览器或长期稳定性已测。

失败分支与移交

轻量化合并节点后，原先可独立驱动的对象可能已不存在，即使旧ID字符串仍在表里，也不能证明能正确选中。外部属性服务缓存旧索引同样会导致错亮。应把ID完整性、可选中和实时数据展示分开检验，不能用名称一致截图替代映射证据。

移交需包含ID约定、模型版本、节点索引对应、映射表版本和冲突处理人。真实联调抽取多个同名设备逐条回读并点亮，保留点位到构件的完整链路；本文只有引用完整性的合成核验，不宣称实际设备已绑定。

基础背景可看孪生数据怎么接进来：从 Modbus、BACnet、OPC UA 到 MQTT 与时序库。构件绑定正确后，还需避免把缺数据显示成零，见孪生看板把无数据画成零，怎样区分 null、缺字段和真实 0。更多资料在数字孪生技术方案。

需要项目联调时，可按上述字段整理资料，联系企服君核对实际接入范围。

一级资料

• 官方资料：§3.3 Indices and Names，名称不要求唯一；自定义稳定ID为应用契约

核对日期：2026-10-24。规范定义与本文应用约定分开，示例门限及脚本不自动代表产品原生能力。