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 更新及故障排查。
限制:资料未提供具体支持设备列表、版本兼容性、价格或收费信息,暂未提供。