Back to Details

home-assistant-esphome

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ESPHome + Home Assistant

ESPHome + Home Assistant

Workflow

工作流

Identify the task: new device/adopt, offline troubleshooting, or YAML feature changes.
For HA-side validation, discover ESPHome entities and map to devices before changing names.
For YAML changes, edit in ESPHome Device Builder (UI-first), validate, then install (USB first flash, OTA thereafter).
When building automations from ESPHome entities, follow
```
home-assistant-best-practices
```
for automation patterns.

确定任务类型：新设备配置/接入、离线故障排查或YAML功能变更。
若在HA端进行验证，请先发现ESPHome实体并将其与设备关联，再修改名称。
若进行YAML变更，在ESPHome Device Builder（优先使用UI）中编辑，验证后进行安装（首次通过USB烧录，后续使用OTA）。
基于ESPHome实体构建自动化时，请遵循
```
home-assistant-best-practices
```
的自动化模式。

HA-side discovery (common)

HA端实体发现（通用操作）

Check integration state:
```
ha_get_integration(query="esphome")
```

Find entities by name or area:

ha_search_entities(query="kitchen", limit=50)

Map entity to device:
```
ha_get_device(entity_id="...")
```

检查集成状态：
```
ha_get_integration(query="esphome")
```

按名称或区域查找实体：

ha_search_entities(query="kitchen", limit=50)

将实体映射到设备：
```
ha_get_device(entity_id="...")
```

Local helper (bundled)

本地辅助工具（内置）

All reference and script files are relative to the location of this SKILL.md file.

Generate a new base64 32-byte key:

Raw:

python3 scripts/gen_esphome_noise_psk.py

YAML block:

python3 scripts/gen_esphome_noise_psk.py --yaml

所有参考文件和脚本文件的路径均相对于本SKILL.md文件的位置。

生成新的32字节base64密钥：

原始格式：

python3 scripts/gen_esphome_noise_psk.py

YAML块格式：

python3 scripts/gen_esphome_noise_psk.py --yaml

References

参考资料

Core resources and docs:
```
references/resources.md
```
YAML snippets and naming patterns:
```
references/snippets.md
```
Troubleshooting:
```
references/troubleshooting.md
```
HA config flow specifics:
```
references/ha-config-flow.md
```

核心资源与文档：
```
references/resources.md
```
YAML代码片段与命名规范：
```
references/snippets.md
```
故障排查指南：
```
references/troubleshooting.md
```
HA配置流程详情：
```
references/ha-config-flow.md
```