用途:为 Home Assistant 构建 Node-RED 可视化自动化流程,基于 node-red-contrib-home-assistant-websocket 节点(v0.80+)。要求 Node-RED 4.x(Node.js 18+)与 Home Assistant 2024.3.0+。
主要能力:涵盖可视化自动化、流程 JSON、trigger-state、api-call-service、function 节点与 context 存储。核心原则是使用当前节点名称,避免旧名导致流程静默失败:server-state-changed 应改用 trigger-state 或 events:state;call-service 应改用 api-call-service。
配置要点:trigger-state 支持 entityIdType 的 exact、substring、regex,无 list 类型,监控多实体需用 regex;api-call-service 可静态指定 domain/service 或通过 msg 动态传入;api-current-state 仅查询单个实体,多实体需用 function 节点。实体节点(如 ha-entity)需额外 hass-node-red 集成,使用时应提示该前置条件。number、select、text、time-entity 节点自 v0.71.0+ 稳定。v0.79-v0.80 弃用状态类型配置,日历事件改用带时区偏移的 ISO 8601 本地字符串并新增 all_day 属性。定时器(如运动灯)用 trigger 节点的 extend: true,不要创建独立的重置节点。流程 JSON 中不应包含 server 配置节点,server 字段留空由用户选择,使用占位实体 ID 并加注释节点说明。function 节点做 HTTP 请求应优先用内置 http request 节点;必须用 function 时需在 settings.js 配置并提醒用户,异步用 node.send() 与 node.done()。context 分 Node、Flow、Global 三种作用域,持久化需在 settings.js 配置 contextStorage。错误处理用 catch 节点限定 scope,错误信息在 msg.error 中。外部 API 集成可参考 popular-apis.md 与 api-catalog 技能。该技能可与 ha-yaml、esphome、api-catalog 配合使用。限制:资料未提供收费、平台与效果等信息。