裝置單元動態擴充（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，可分別完成範本實例設定和規則試算、影響分析及釋出。