天气与旧远程资源
当前活动来源为设备屏幕的单一“心知天气”实况组件。旧远程 MQTT 通道、自定义 HTTP 来源和多天气来源已退出活动配置,不能按早期文档继续创建远程开关、场景或可写数值。
配置天气
在“设备屏幕”的心知天气组件配置城市和 API Key,选择每 15、30 或 60 分钟自动刷新。来源固定为 seniverse、实况 now.json 接口和摄氏单位;不提供自定义 URL、三日预报或任意 JSON 路径读取。API Key 是私有凭据,公开示例与报告不要包含真实值。
固件须编译 remoteResources,依赖网络、时间与资源准入,并按设备返回状态判断是否可用。旧配置中的来源与凭据保留为迁移资料;确认保留的心知天气来源或新建来源后,系统规范化为最多一个活动天气来源。若删除的来源仍被规则引用,包括停用规则,迁移会拒绝并要求先调整引用,不能静默丢弃配置。
刷新与显示
手动刷新与规则动作 34 都只请求已配置来源更新,受最短间隔和待处理状态限制。accepted=true 仅表示已接收请求;应继续查看 pending、结果、原采样时间与质量。限流、无网络、服务错误及过期结果不能用零值伪装新天气。反复刷新不会延长旧样本有效期。
动作 34 的 targetPeriphId 为设备返回的实际天气来源 ID,actionValue 必须为空。不能填入 URL,也不能借此查询 MQTT 通道。
当前接口
| 路径 | 方法与用途 |
|---|---|
/api/screen-panel/weather | GET 查看;POST 保存天气配置 |
/api/screen-panel/weather/refresh?id=<来源ID> | POST 请求刷新;GET 查看刷新状态 |
/api/remote-resources | GET/POST 均返回 410,旧入口停用 |
/api/remote-resources/weather-test | GET/POST 均返回 410,旧测试入口停用 |
接口要求登录;保存和刷新状态/请求还要求开发环境功能开启。保存使用设备返回的版本,冲突返回 409 后先刷新配置。完整配置正文上限 8 KiB。
旧规则处理
动作 33 保留编号用于识别退休配置,不能执行远程通道控制。绑定旧 remote. 数据源或 ds:remote. 事件的规则会暂停整条规则,包含其中其他 OR 触发器。修改前核对规则状态与暂停原因,重新选择当前来源和动作,不自动转投其它设备。此保护不代表旧远程负载的实际状态已确认。

