暖通自动化控制 — 部署指南

部署预测与控制服务，填写电表、控制模式、安全限值和告警参数。

打开控制台，创建首个管理员账号，确认步骤 1 配置的数据源在线。

注册电表，在观察模式下运行预测，逐项触发故障验证回滚和告警，全部通过后再开启写入。

打开写后核实（回滚）

写后核实默认关闭。在控制台创建预测运行时加上 rollback 段：

{
  "schema_version": "prediction-run.v3",
  "interval_seconds": 60,
  "rollback": { "enabled": true, "settle_seconds": 2.5 }
}

settle_seconds（0–30，默认 1.0）必须大于数据源的采集间隔，否则会误报读回不一致。只核实 Modbus 点位，BACnet 输出不核实。

后续步骤

• 查看完整工程 Wiki 与二次开发指南

快速验证

1. docker inspect -f '{{.Config.Image}}' missionpack_knn 返回的是你打算运行的版本。
2. SDM630 的十个点位全部可读，电压、频率和进口电能与电表本机显示一致。
3. 进口有功电能只增不减，数据源重启后保持累计值。
4. 观察模式下跑完一个完整人流周期的预测，推荐值经机组操作人员审阅。
5. 安全限值已填入批准人姓名，基线不再报告为未批准。
6. 一次限值范围内的写入产生了命令回执，读回在容差内，点位质量为 good。
7. 数据源离线、读回不一致、样本过期三类故障各自产生预期告警，前两类各触发一次回滚。
8. 启用了北向上云时，GET /system/runtime-metrics 中的 northbound.spool.queued 为 0 且 dropped 未增加。

需要导出的证据

交接记录包括：镜像版本；电表模板 id 与确认后的字序；批准的安全限值与批准人；已核实写入的命令审计记录；故障注入产生的回滚日志；告警历史。容器日志（docker logs missionpack_knn）会轮转覆盖，及时拷出。

下一步

1. 先只在一个区域开启写入，观察满一个周期再扩大范围。
2. 为 critical 级 compensation-failed 告警配置通知。
3. 机组每次再平衡后重新批准安全限值。