From 957c64d7958ae8cfdc393f5898d547e3e1fe5d0a Mon Sep 17 00:00:00 2001
From: host <arumyantsev@rummail.ru>
Date: Wed, 29 Jul 2026 19:41:44 +0300
Subject: [PATCH] =?UTF-8?q?v2.3.0=20=E2=80=94=20README=20=D0=BE=D0=B1?=
 =?UTF-8?q?=D0=BD=D0=BE=D0=B2=D0=BB=D1=91=D0=BD:=20=D0=BE=D0=BF=D0=B8?=
 =?UTF-8?q?=D1=81=D0=B0=D0=BD=D0=B8=D0=B5=20list=5Fdevices=20=D0=B8=20?=
 =?UTF-8?q?=D0=BF=D1=80=D0=B8=D0=BC=D0=B5=D1=80=D1=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 26 ++++++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 94467b9..d218b2d 100644
--- a/README.md
+++ b/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, ретраи, кэш