1. 模板
2.00.066 属性功能：服务端／共享属性默认不转发，仅发送勾选字段；过程属性（
process_data）用于持久化计算状态。操作、脚本和模板行为见设备属性转发与过程数据。
模板是将多个模型和配置预设组合成可复用集合的功能。用户在单个新增设备或批量导入时，可以选择一个模板，一键完成所有绑定模型和默认参数的配置，避免重复手工操作。
1.1. 创建模板
进入 模型 → 模板，点击 新增。配置对话框包含以下几个部分。
1.1.1. 基本配置
| 字段 | 说明 |
|---|---|
| 名称 | 模板的唯一显示名称。 |
| 心跳周期 (S) | 设备预期的心跳上报间隔，单位为秒，默认值 86400（24 小时）。用于判断设备在线/离线状态。 |
| 在离线通知 | notify_offline，字符串 "TRUE" / "FALSE"，默认关闭；见本页兼容性说明。 |
| 实时存储 | 选择应用于该模板下设备的实时数据存储策略。 |
| 地理位置 | 为通过该模板创建的设备绑定地理位置信息。 |
| 标签 | 为模板绑定一个或多个标签。通过该模板创建的设备将继承这些标签，可用于筛选和分组。 |
1.1.2. 模型绑定
| 字段 | 说明 |
|---|---|
| 物模型 | 选择物模型，定义该模板下设备的数据点和属性结构。 |
| 联动模型 | 选择联动模型，为所有通过该模板创建的设备应用事件驱动逻辑。 |
| RPC | 绑定 RPC 配置，使所有通过该模板创建的设备自动具备相应的远程指令能力。 |
1.1.3. 集成选项
以下集成可在模板中预先启用和配置。通过该模板创建设备时，所选集成将自动应用到设备。
| 字段 | 说明 |
|---|---|
| BACnet | 启用 BACnet 集成设置。 |
| MCP | 启用 MCP 相关选项。 |
当前新增窗口还提供 ModbusTcpServer 开关、制造商、设备型号、备注和 Skill。实时存储初值为开启；BACnet、ModbusTcpServer 初值均为关闭。MCP 是选择控件，不应一概按布尔开关理解。
模板心跳周期初值为 86400 秒，输入下限为 0。模板中的位置、模型和协议选项是设备预设；保存模板并不等于启动外部协议服务，也不代表已有设备已重新应用该模板。
1.2. 属性配置
模板支持预定义两类属性，通过该模板创建的设备会自动继承这些属性。
服务端属性
服务端属性由平台侧存储和管理，通常用于设备标识、配置参数或服务器控制的元数据。
| 列名 | 说明 |
|---|---|
| 序号 | 自动递增的行号。 |
| 名称 | 属性的显示名称。 |
| 属性名 | 在数据模型和 API 中使用的键名。 |
| 单位 | 可选的单位标签（如 °C、kWh）。 |
| 默认值 | 通过该模板创建设备时自动填入的初始值。 |
| 备注 | 可选的描述或说明信息。 |
点击服务端属性区域的 新增 按钮可添加新的属性行。
共享属性
共享属性可由平台和设备双方读取，通常用于可下发到设备的配置值（如上报间隔、阈值设置等）。
列结构与服务端属性相同。
在模板中设置属性后，这些属性也可在关联的物模型中被引用。通过该模板创建设备时，所有预定义的服务端属性和共享属性会自动添加到该设备的属性列表中。
1.3. 使用模板
新增单个设备
在新增设备时，从设备创建表单的 模板 下拉框中选择对应模板。保存后，模板中定义的所有模型绑定、集成配置和默认属性值将立即生效。
批量导入
通过 CSV 或批量导入方式导入设备时，可在导入文件中指定模板名称，或在导入对话框中选择模板。该批次内所有设备将共享所选模板定义的模型绑定、集成设置和默认属性值。
1.4. 位置与 AI 描述
设备配置模板现在可以维护 location_code、remark 和 skill：
| 字段 | 说明 |
|---|---|
location_code | 通过该模板生成设备时默认绑定的位置编码。位置编码来自 位置管理 中的 code。 |
remark | 模板备注。 |
skill | 面向 AI 助手或运维人员的设备描述，可记录设备型号、接线方式、维护规则和排障提示。 |
如果模板中的位置编码不存在，后续设备导入或生成时可能不会绑定位置。建议先在位置管理中维护位置，再在模板中引用。
1.5. 模板创建设备与重置可靠性（2.00.070）
通过模板新增设备或重置设备配置时，相关写入进入统一设备写入队列；数据库事务提交成功后才刷新缓存、释放队列，再通知 Modbus。事务失败不会把未提交的配置写入缓存，也不会通知外部服务。
重置保留现有设备实例和过程数据（process_data），也保留数据库等待期间脚本产生的新转发规则，并重新纳入持久化缓冲。模板不存在或当前账号无访问权时，系统会在写入前返回明确错误。
Modbus 通知失败会记录日志，不会把已提交的保存报告为失败；遇到这种情况，应分别检查已保存配置和协议服务日志。保存模板本身仍不代表已有设备已重新应用模板。
在离线通知与兼容性（2.00.084）
模板基本配置新增“在离线通知” notify_offline，值为字符串 "TRUE" / "FALSE"，默认 "FALSE"。按实际消息周期配置心跳（秒），开启后严格超过两倍心跳判离线；无效心跳回退 900 秒，对应超过 1800 秒。界面心跳初值与检测器回退值含义不同。
通过模板新增设备继承开关；模板重置应用开关与心跳，保留设备最新活动时间并重新判断。保存模板本身不重置已有设备。旧 Excel 缺列时，更新现有设备保留原值，普通新增默认关闭，通过模板新增继承模板；新列存在但为空按默认关闭处理。
关闭后停止检测，保留最后 _online 且不额外发离线事件；重新开启无状态时初始化通知，有效状态未变不重复通知。历史消息按本次接收时间刷新，不能据此判断数据新鲜或设备正常。完整状态口径及字段区别见设备管理。