1. 模板

模板是将多个模型和配置预设组合成可复用集合的功能。用户在单个新增设备或批量导入时，可以选择一个模板，一键完成所有绑定模型和默认参数的配置，避免重复手工操作。

1.1. 创建模板

进入 模型 → 模板，点击 新增。配置对话框包含以下几个部分。

1.1.1. 基本配置

字段	说明
名称	模板的唯一显示名称。
心跳周期 (S)	设备预期的心跳上报间隔，单位为秒，默认值 86400（24 小时）。用于判断设备在线/离线状态。
实时存储	选择应用于该模板下设备的实时数据存储策略。
地理位置	为通过该模板创建的设备绑定地理位置信息。
标签	为模板绑定一个或多个标签。通过该模板创建的设备将继承这些标签，可用于筛选和分组。

1.1.2. 模型绑定

字段	说明
物模型	选择物模型，定义该模板下设备的数据点和属性结构。
联动模型	选择联动模型，为所有通过该模板创建的设备应用事件驱动逻辑。
RPC	绑定 RPC 配置，使所有通过该模板创建的设备自动具备相应的远程指令能力。

1.1.3. 集成选项

以下集成可在模板中预先启用和配置。通过该模板创建设备时，所选集成将自动应用到设备。

字段	说明
ThingsBoard	配置 ThingsBoard 数据转发。
告警	绑定告警配置。
BACnet	启用 BACnet 集成设置。
Home Assistant	启用 Home Assistant 集成设置。
MCP	启用 MCP 相关选项。

1.2. 属性配置

模板支持预定义两类属性，通过该模板创建的设备会自动继承这些属性。

服务端属性

服务端属性由平台侧存储和管理，通常用于设备标识、配置参数或服务器控制的元数据。

列名	说明
序号	自动递增的行号。
名称	属性的显示名称。
属性名	在数据模型和 API 中使用的键名。
单位	可选的单位标签（如 °C、kWh）。
默认值	通过该模板创建设备时自动填入的初始值。
备注	可选的描述或说明信息。

点击服务端属性区域的 新增 按钮可添加新的属性行。

共享属性

共享属性可由平台和设备双方读取，通常用于可下发到设备的配置值（如上报间隔、阈值设置等）。

列结构与服务端属性相同。

在模板中设置属性后，这些属性也可在关联的物模型中被引用。通过该模板创建设备时，所有预定义的服务端属性和共享属性会自动添加到该设备的属性列表中。

1.3. 使用模板

新增单个设备

在新增设备时，从设备创建表单的 模板 下拉框中选择对应模板。保存后，模板中定义的所有模型绑定、集成配置和默认属性值将立即生效。

批量导入

通过 CSV 或批量导入方式导入设备时，可在导入文件中指定模板名称，或在导入对话框中选择模板。该批次内所有设备将共享所选模板定义的模型绑定、集成设置和默认属性值。