docs: troubleshooting «Invalid handler specified» (нет pyfglair / нет перезапуска)

- README компонента: проверка лога, установка pyfglair в окружение HA
  (docker exec python -m pip), полный перезапуск, проверка импорта
- RELEASE_HA: та же диагностика в разделе установки
This commit is contained in:
2026-09-29 16:13:19 +03:00
parent 8a073d96a6
commit 49d5533cd1
2 changed files with 35 additions and 0 deletions
+7
View File
@@ -57,6 +57,13 @@ Workflow собирает `wheel` + `sdist`, прогоняет smoke-тест
тогда HA сам поставит `pyfglair` из манифеста. Учтите риск dependency
confusion при `--extra-index-url` — для внутреннего стенда допустимо.
Если при добавлении интеграции HA пишет «Invalid handler specified» —
пакет `pyfglair` не установлен (или компонент не перезапущен). Смотрите
`grep -iE "fglair|pyfglair" /config/home-assistant.log`: при
`ModuleNotFoundError: No module named 'pyfglair'` установите пакет в
окружение HA (`docker exec homeassistant python -m pip install ...`) и
полностью перезапустите HA.
* **Публичный PyPI** — см. §2 (для распространения вне сети).
### 1.3. Обновление интеграции