版本说明与已知限制
本页说明当前版本的功能边界。了解"平台不做什么"和"什么即将支持"，有助于合理规划接入方案、避免不必要的设计返工。
当前版本能力一览
| 能力域 | 当前支持 |
|---|---|
| 设备接入 | MQTT 协议；直连设备 + 网关代理子设备两种形态 |
| 数据上报 | 遥测（时序存储）+ 属性（最新值） |
| 数据查询 | 最新值快照、历史曲线、按窗口降采样聚合（avg/min/max/sum/first/last） |
| 告警 | 计算字段阈值规则、多等级条件组、防抖（持续/连续）、清除条件、告警生命周期 |
| 实时性 | SSE 服务端推送（监控页自动刷新） |
| 组织 | 多租户隔离、客户分层、三级角色 |
| 配额 | 最大设备数、最大客户用户数、每日最大消息数 |
| 指令下发 | 设备 RPC（one-way，离线不排队） |
| 治理 | 操作日志、API Key、文件上传 |
已知限制
理解以下限制的存在原因，可以避免踩坑：
设备接入
- 仅支持 MQTT：HTTP、CoAP、Modbus、TCP 透传等其他协议通道尚未提供。现场有非 MQTT 设备时，请在边缘侧先转换为 MQTT（网关正是为此设计的角色）；
- RPC 为单向无回执：下发后不等待设备返回结果、设备离线时直接失败不排队。需要"执行结果"的场景，请让设备执行后通过遥测/属性上报结果。
数据
- 遥测删除仅支持按设备：可清空某台设备的全部或指定时间段数据，不支持按单个字段删除；
- 无数据导出：暂未提供 CSV/Excel 导出，重要数据请通过 API 自行拉取归档；
- 历史数据不追溯评估：告警规则只对新上报的数据生效，修改规则不会对历史数据补算。
告警与通知
- 通知渠道有限：当前通过站内通知触达；邮件、短信、IM 推送尚未接入；
- 规则绑定单台设备：一条告警规则只作用于一台设备，批量场景需按设备分别创建。
平台能力
- 无移动端 App：移动端规划中，当前请使用浏览器；
- 无计费体系：租户计量与账单未开放，资源约束通过配额模板实现；
- 无设备固件 OTA：固件升级需在设备端自行实现。
规划中（后续版本）
| 方向 | 说明 |
|---|---|
| 设备档案（DeviceProfile） | 设备配置模板（传输方式、默认配置），能力已在后端就绪，界面将在后续版本开放 |
| 告警通知增强 | 邮件、短信、Webhook、IM 推送渠道 |
| 更多接入协议 | HTTP / CoAP / 工业总线透传 |
| 数据导出 | CSV / Excel 导出 |
| 仪表板增强 | 可自定义的仪表板布局与持久化 |
规划内容以实际发布为准。有明确需求请向平台管理员反馈，需求热度直接影响排期优先级。
给接入决策者的建议
基于以上边界，接入方案设计时请注意：
- 非 MQTT 设备一律走网关转换，不要等待平台支持现场总线协议；
- 关键控制动作设计闭环：RPC 无回执，执行结果请通过数据上报确认；
- 字段命名与类型当作接口契约管理：改名、改类型的代价是历史数据断裂；
- 上报频率 × 设备数提前对齐配额，避免上线后数据静默丢弃。