Документация: как работает Tg-notify.bot (подсистемы, поток, API, состояние инстанса)

- README: расширен раздел Tg-notify.bot — три подсистемы, поток привязка/подписка/CheckAll,
  полная таблица конфига (+kp_api_key, +tmdb_lang), быстрый старт, команды, HTTP API,
  фактическое состояние инстанса (bot_token пуст, /lite/mirage=disable, /lite/collaps=503)
- AGENT.md: правило 11 — эксплуатация бота, диагностика, данные database/tgnotify

AGENT.md

@@ -112,3 +112,11 @@ docker exec lampac sh -c '...'  # осмотр состояния в конте
 ### 10. Безопасность (не публиковать)
 
 `config/passwd`, cookie `accspasswd`, заголовок `lcrqpasswd`, `bot_token` в `TelegramBot`. Маршруты `/adminpanel`, `/weblog`, `Tracks`, `Catalog`, `DLNA`, proxy-модули — только для доверенной сети без WAF не открывать.
+
+### 11. Tg-notify.bot (Telegram-бот)
+
+- Механика: long polling по `TelegramBot.bot_token`; если токен пуст — polling не стартует (в логе `[TelegramBot] Установите bot_token…`, сервер работает). После правки секции: `docker compose restart lampac`.
+- Три подсистемы: трекер серий (Trakt→TMDB), трекер озвучек (параллельно Mirage/Collaps/VideoHub через `lampac_host`: `/lite/mirage`, `/lite/collaps`, `/lite/cdnvideohub`), клиентский плагин `tg-notify.js` (вкладка «TG Подписки», перехват 🔔). Полный разбор — в README.md.
+- Данные подписок: `database/tgnotify/{users.json,subscriptions.json}` (том `./database/`, в .gitignore). Не «чинить» вручную — это живые данные бота.
+- Диагностика: `GET /tg-notify.js` (200 без авторизации), `GET /api/tg/voices` (200), `/api/tg/*` остальной — требует `user_uid`. Озвучки могут не работать, если балансеры недоступны (проверить `GET /lite/mirage` — тело `disable`/ошибка, `/lite/collaps` — 503); тогда уведомления приходят только о выходе серий.
+- `kp_api_key` опционален: без него VideoHub резолвит `kinopoisk_id` только через мост `/externalids` (покрытие ~40%), иначе — молча пропускается, Mirage/Collaps работают.