SuperAPI AI 工具集

ha-scripts

通用与其它

查看项目

更新于 10-15 23:48

技能介绍

用途:编写 Home Assistant 的 YAML 脚本。脚本是可调用、可复用的动作序列,与自动化不同,它没有触发器,必须被显式调用。

主要能力:提供脚本模板与 YAML 风格规则,支持定义字段(fields)作为可选参数,并可设置运行模式(mode:single、restart、queued、parallel)。

风格规则:使用 2 空格缩进(禁止制表符);布尔值小写 true / false;实体 ID 采用 domain.entity_name 形式(小写、下划线)。

用法示例:在 script: 下定义脚本,如 morning_routine,包含 alias、mode、fields(含 description、default、selector)与 sequence。sequence 中可调用动作,例如 light.turn_on 配合 target.area_id 与 data.brightness_pct 使用模板 '{{ brightness }}',也可使用 delay,以及 media_player.play_media(media_content_id 需为提供方特定的媒体 ID,如 spotify:playlist:... 或 media-source://...,而非自由文本名称)。

调用方式:在自动化中通过 - action: script.morning_routine 并传入 data(如 brightness: 80);或在界面中通过 Developer Tools → Actions → script.morning_routine 调用。

选择建议:由事件或状态变化触发时用自动化;被多个自动化调用或需要复杂可复用逻辑时用脚本;一次性响应触发器用自动化。

相关技能:自动化见 ha-yaml-automations,蓝图见 ha-blueprints。

限制:资料未提供更多关于平台、收费或效果的信息。