mcpField
H
home-assistant-esphome

home-assistant-esphome

github.com/bradsjm其他46652 次安装16 周前更新
代码仓库

关于 home-assistant-esphome

为 ESPHome 与 Home Assistant 工作流提供指导，面向设备配置、故障排查和自动化任务。内容涵盖实体发现、YAML 修改与验证，并附带生成 Noise PSK 的脚本。

主要功能

  1. 01按新设备、离线故障和 YAML 变更分类处理
  2. 02发现 ESPHome 集成、实体与设备
  3. 03通过 ESPHome Device Builder 编辑并验证 YAML
  4. 04提供 Noise PSK 生成脚本
  5. 05附带配置、示例与故障排查参考

适用场景

  1. 01将新设备接入 Home Assistant
  2. 02排查 ESPHome 设备离线问题
  3. 03修改并验证设备 YAML 配置
  4. 04基于 ESPHome 实体构建自动化

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-esphome

安装后在 Claude Code 中输入/home-assistant-esphome确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
ha-config-flow.md
resources.md
snippets.md
troubleshooting.md
scripts/
gen_esphome_noise_psk.py

详细介绍

ESPHome + Home Assistant

工作流

  • 确定任务类型：添加/接入新设备、排查离线问题，或更改 YAML 功能。
  • 在 HA 端验证时，先发现 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

评论

支持 Markdown