设备协同与共享目标

设备共享让其他 Edge-EMS Builder 节点的数据参与本机计算和策略。当前共享目标采用“本机 → 一个目标设备”的方向模型，可以组合成汇聚、双向或多级协同。

三个配置对象

对象	作用
设备信息	用唯一设备编码识别节点，记录网络地址和是否本机
共享配置	选择本机点位和共享周期
共享目标	指定一个接收设备，并绑定一份或多份共享配置

共享目标由本机发起，不需要填写从设备列表。向多个设备发送时创建多个目标；多个节点向同一汇聚节点发送时，各自配置对应目标。

配置顺序

1. 在参与设备上维护设备信息，确认本机标记与唯一设备编码。
2. 在发送端创建共享配置，选择点位并设置 CRON 周期。
3. 创建指向接收端的共享目标，绑定需要发送的配置。
4. 在接收端检查共享点位、来源设备和最新值。

需要双向共享时，两端分别配置。多级汇聚可将收到的数据计算成本机聚合指标，再共享给上一级。

详细操作见 设备协作配置，字段说明见 共享目标参考。

数据身份与计算

共享数据会携带名称、别名和单位。相同 dataKey 可以来自不同设备，因此查询时应同时指定设备编码，不手工拼接缓存键。

-- demo_edge 和 demo_power 均需替换为实际编码
local localPower = tonumber(${demo_power})
local remotePower = tonumber(${[demo_edge]demo_power})
if not localPower or not remotePower then return "__Null__" end
return localPower + remotePower

历史查询、分组映射及控制日志也应保留同一来源身份。

远端控制

触发动作可以通过设备编码向远端可写点位下发指令。目标数据类型填写远端实际类型，例如采集点位为 Collection：

return {buildSlaveWriteMap("demo_edge", "Collection", "demo_setpoint", 10, nil, nil, false)}

请求已发送不代表设备已执行。应核对权限、设备应答、执行端日志与点位回读，详见 设备控制日志。

状态与网络恢复

设备状态可参与策略判断；使用远端值时应同时检查通信状态和数据时效。设备共享依赖节点之间网络可达，设备编码用于识别，IP 用于连接。

在支持的 Linux 网络环境下，本机外网不可用时可借用在线设备网络；直连恢复后切回本机网络，包括同网卡共享场景。该能力依赖现场路由与权限，应在实际设备上验证。

更换接收节点时更新共享目标的目标设备编码；只是地址变化时更新该设备信息，并检查连接及绑定。批量同类设备可以用 UDE 生成配置，也可使用 设备共享 Skill。