设备单元动态扩展（UDE）

UDE 用一套模板管理同类设备。新增设备时自动生成聚合点位、分组和共享配置；模板调整后，可以通过“对账”让已有实例同步更新。

模板与实例

对象	作用
设备单元类型	定义同类设备的命名规则与模板
设备单元实例	某台设备上的一个具体单元，例如 METER#1
聚合模板	生成计算点位、单位、表达式和初始值
分组模板	生成父子分组、点位映射和排序
共享模板	生成共享点位列表，并绑定共享目标

系统按 聚合 → 分组 → 共享 的顺序处理，后一步可以引用前一步的结果。分组模板支持树状查询、指定父分组，也可以由单个实例覆盖根父分组。

命名与自动识别

例如 METER#1_power 中，METER#1 是实例前缀，power 是点位后缀。实例前缀不能包含下划线；同一设备上的前缀应唯一，同类设备保持相同的后缀规则。

CommBridge 配置同步、共享数据到达时，系统会识别符合规则的实例。也可以扫描已有数据，补充后来才配置模板的设备。

动态占位符

不同设备的名称、分组位置或来源不同，可以用 {token} 占位符复用同一模板：

• 规则集：组织一组占位符，可绑定到设备单元类型。
• 匹配规则：根据设备编码、实例前缀或序列号生成占位符的值。
• 作用范围：分别用于分组、来源设备、表达式、初始值或共享配置。
• 试算与影响预览：保存前检查渲染结果，禁用或删除规则前查看影响范围。

UDE 的 {token} 在模板生成时处理；Lua 的 ${dataKey} 在表达式运行时读取点位。两者用途不同，模板试算后还应验证生成的 Lua 表达式。

对账如何更新配置

对账会补齐缺失配置，并更新模板管理的字段、分组映射及共享绑定。它不是简单地“只新增、不修改”。

1. 定义类型和模板，准备需要引用的父分组、共享目标。
2. 对一个测试实例执行对账，检查生成结果。
3. 确认后，对该类型或全部类型执行批量对账。
4. 查看实例的物化状态和错误；接口显示“已调度”时，后台可能还在处理。

当前版本保存或删除模板时，会校验变更并调度受影响的已有实例。发布前应确认影响范围；父分组尚未就绪时查看状态和重试信息，修正依赖后再核对结果。

生成配置带有归属和指纹，用于识别模板变化与人工修改冲突。聚合模板的初始值未变化时，重复对账不会把正常运行值重置为默认值。删除模板或更改编码后，也不要假定全部旧业务对象都会自动删除，应检查引用及清理结果。

适用场景

同型号设备会扩容、多站点需要复用配置，或设备数量较多时，UDE 可以减少重复配置。少量固定设备也可以直接管理点位。

相关能力：数据模型、设备共享。通过 Agent 配置时，使用 UDE 与动态占位符 Skills，可分别完成模板实例配置和规则试算、影响分析及发布。