v2.3.0 — README обновлён: описание list_devices и примеры

README.md

@@ -4,7 +4,7 @@
 
 ## Возможности
 
-### Управление
+### Управление (`smart`)
 - Свет (вкл/выкл, яркость, цветовая температура)
 - Розетки и выключатели
 - Климат (температура, режимы нагрев/охлаждение)
@@ -15,7 +15,7 @@
 - Роботы-пылесосы
 - Сценарии и скрипты
 
-### Мониторинг (ответы на вопросы)
+### Мониторинг (`smart` — ответы на вопросы)
 - Какие окна/двери открыты
 - Что горит лишнего
 - Какая температура в комнатах
@@ -23,6 +23,13 @@
 - Что сейчас играет
 - Кто дома
 
+### Диагностика (`list_devices`)
+- Полный список устройств по доменам
+- Фильтр по `device_class` (door, window, motion, battery, ...)
+- Фильтр по состоянию (`on`, `off`, `open`, `closed`, ...)
+- Скрытие `unavailable` / `unknown`
+- Спецкатегория `domain="window_door"` для окон и дверей
+
 ## Установка
 
 ### Просто скопировать
@@ -89,6 +96,20 @@ Open WebUI → **Settings → Interface → Tools** → включите `Home A
 что сейчас играет?
 ```
 
+### Диагностика (отдельный инструмент `list_devices`)
+
+LLM может вызвать инструмент `list_devices` с параметрами, например:
+
+```
+list_devices()                                    # все устройства
+list_devices(domain="binary_sensor")               # все бинарные датчики
+list_devices(domain="window_door")                 # только окна/двери
+list_devices(device_class="battery")               # только батарейки
+list_devices(only_with_state="unavailable")        # все offline
+list_devices(show_unavailable=False)               # скрыть offline
+list_devices(domain="binary_sensor", show_unavailable=False)
+```
+
 ## Безопасность
 
 - Токен HA хранится в **Valves** Open WebUI, не в коде
@@ -99,6 +120,7 @@ Open WebUI → **Settings → Interface → Tools** → включите `Home A
 
 ## Версионирование
 
+- **v2.3.0** — добавлен инструмент `list_devices` для диагностики и инвентаризации
 - **v2.2.2** — восстановлен полный код после повреждения при обновлении
 - **v2.2.1** — HTTPS по умолчанию, verify_ssl в Valves
 - **v2.2.0** — мониторинг (окна, свет, климат, батарейки, медиа, присутствие), dry-run, ретраи, кэш