SuperAPI AI 工具集

home-assistant-esphome

办公与效率

查看项目

更新于 10-15 12:22

技能介绍

ESPHome + Home Assistant 工作流

用途:该技能用于处理 ESPHome 与 Home Assistant 之间的设备配置、接入、命名、加密密钥、OTA 更新与排障等工作。

主要能力:

  • 识别任务类型:新设备/收养、离线排障,或 YAML 功能变更。
  • Home Assistant 侧验证:在修改名称前,发现 ESPHome 实体并映射到设备。
  • YAML 变更:在 ESPHome Device Builder 中编辑(UI 优先),验证后安装;首次通过 USB 刷写,后续使用 OTA。
  • 基于 ESPHome 实体构建自动化时,遵循 home-assistant-best-practices 的自动化模式。

使用方式:

  • HA 侧发现常用操作:检查集成状态(ha_get_integration(query="esphome"));按名称或区域查找实体(ha_search_entities(query="kitchen", limit=50));将实体映射到设备(ha_get_device(entity_id="..."))。
  • 本地辅助(随附):所有参考和脚本文件相对于本 SKILL.md 文件所在位置。生成新的 base64 32 字节密钥:原始输出:python3 scripts/gen_esphome_noise_psk.py;YAML 块:python3 scripts/gen_esphome_noise_psk.py --yaml。

参考文档:

  • 核心资源与文档:references/resources.md
  • YAML 片段与命名模式:references/snippets.md
  • 排障:references/troubleshooting.md
  • HA 配置流细节:references/ha-config-flow.md

适用场景:适用于智能家居设备通过 ESPHome 接入 Home Assistant 的配置、命名、加密密钥设置、OTA 更新及故障排查。

限制:资料未提供具体支持设备列表、版本兼容性、价格或收费信息,暂未提供。