SuperAPI AI 工具集

ha-blueprints

办公与效率

查看项目

更新于 10-15 23:48

技能介绍

用途:编写 Home Assistant 的 YAML 蓝图(Blueprint),即带可配置输入的可复用自动化模板,用户可用同一蓝图以不同设置创建多个自动化。

主要能力与要点:

  • 蓝图结构:顶层包含 blueprint(name、description、domain,domain 通常为 automation,也可为 script)、input 输入定义,以及 trigger 和 action 主体。
  • 输入与选择器:input 下每个输入可含 name、selector,以及可选的 default(使输入变为可选,未设置时使用默认值)。selector 决定 HA 前端显示的选择器类型,如实体选择器(entity + filter,可过滤 domain、device_class)、区域选择器 area、数字滑块 number(min、max、unit_of_measurement)、布尔开关 boolean、时间选择器 time。
  • 引用输入:在蓝图主体任意位置用 !input 引用用户提供的输入值。
  • YAML 风格规则:使用 2 空格缩进(禁止 tab);布尔值小写 true / false。

使用方式:将蓝图文件保存到 config/blueprints/automation/your-name/blueprint-name.yaml,可通过 GitHub 共享,用户用原始文件 URL 导入。

适用场景:需要把重复的自动化逻辑抽象成模板并暴露参数时,例如运动触发灯光、延时关闭一类的自动化。

限制:资料仅提供蓝图的 YAML 结构与共享方式,未提及收费、价格、平台或效果等信息;相关联技能为 Automations → ha-yaml-automations、Scripts → ha-scripts。