agent.py разбирает фразу в план (намерение, персона, жанр, тема, эпоха,
оценка) и выполняет запрос. Словарь берётся из графа, поэтому агент знает
только то, что есть в медиатеке.
Понимает русские синонимы (фантастика → science fiction, искусственный
интеллект → artificial intelligence, робот → robot) и транслитерацию имён
(«фильмы Нолана» → Christopher Nolan). Эпохи в любом виде, оценки по словам.
Пять намерений: подбор, фильмография, по десятилетиям, похожее, сравнение.
При пустом результате ослабляет условия по одному и сообщает об этом.
Показывает, как понял запрос.
Вызовы: команда «агент», свободный текст Медиа-бота, и «найди» с падением
в граф, когда в Jellyfin пусто.
Проверено: Нолан → Interstellar; ИИ по десятилетиям (1980-е 1, 1990-е 1,
2000-е 2, 2010-е 2); похоже на Дюну → 8 фильмов; высокорейтинговые 80-х →
Blade Runner; «найди про роботов с рейтингом» → 7 фильмов.
Попутно: /pick получил фильтры по персоне и оценке; /compare сравнивает
книгу и фильм (общие и разные жанры, автор, связь экранизации); поиск ядра
понимает русские окончания (Дюну → Dune).
Ловушки: явная команда первым словом (иначе «похоже» перехватывало запрос),
порог основы для коротких слов, и восстановление аналитических функций,
случайно срезанных при замене do_pick.
Ядро: GET /graph (статистика и JSON узлов/рёбер), /timeline (тема по
десятилетиям), /cross (книги с экранизацией и авторы), /persons (топ персон).
Бот: команды «граф», «время <тема>», «кросс», «персоны режиссёры».
Проверено: science fiction по десятилетиям с фильмами, Dune ↔ Dune (2021),
Frank Herbert → Dune, Дени Вильнёв — 4 фильма.
Панель: раздел «Медиа: граф контента» с числом карточек и связей, таблицей
связей с диаграммами и списком книг-экранизаций. Панель выросла до 10.4 КБ.
Ловушки: /person перехватывал /persons (уточнён маршрут); «персоны режиссёры»
разбиралось как поиск человека по имени «режиссёры» — добавлено распознавание
запросов-списков.
Граф: композиторы из Credits.Crew (10 связей «музыка») и автор → фильм
(«экранирован»: Frank Herbert → Dune 2021). Итого 369 карточек, 387 связей.
Ядро: GET /pick с фильтрами genre/theme/decade — подбор из имеющегося с
оценкой и жанрами. Композиторы добавлены в /person.
Бот: команда «посмотреть» разбирает эпоху (80-е, 1999, 2020-е) и подбирает
фильмы, пробуя комбинации жанр+эпоха, тема+эпоха, жанр, тема, эпоха.
Проверено: 80-е → Blade Runner, 1999 → Fifth Element и Matrix,
2020-е → оба Dune, science fiction → 5 фильмов с оценками.
Ловушка: двузначный год превращался в «800-е» — добавлено правило века.
Ядро: GET /person?q= (персона и её фильмы), GET /similar?id= (прямые
связи «похож» плюс карточки с общими темами и жанрами, два шага по графу).
Бот Медиа: !персона Zendaya → фильмы персоны; !похоже Дюна → прямо
связанные и общие темы с числом совпадений. В «похожее» попадают и книги:
Dune связан с книгой через общий жанр.
Проверено: Keanu Reeves → 3 фильма Matrix; похоже на Dune: Part Two →
Dune (2021) с 4 совпадениями, Interstellar и The Fifth Element по 2.
Ловушка: первая версия /similar возвращала сами темы вместо фильмов —
нужен двухшаговый запрос (карточка → темы → другие карточки с теми же темами).
Добавлены связи из SkyHook: режиссёры и актёры (Credits), рекомендации
(Recommendations), оценки IMDb по корзинам, возрастной рейтинг, язык.
Русские названия из AlternativeTitles сохраняются как алиасы — поиск
«Дюна» находит Dune.
Итог: 359 карточек и 376 связей (было 182 и 193), 48 актёров, 6 режиссёров,
41 кандидат, 42 темы.
Новые команды бота Медиа: «тема <слово>» (подборка), «связи <название>»
(вся карточка со связями), «рекомендации» (что посмотреть из кандидатов).
Доработано в ядре: /entities с фильтром по виду и лимитом, поддержка
aliases при создании карточки.
Ловушки: кириллица в query требует urlencode; псевдоним «связи» перехватывался
командой link — переопределён ALIASES в MediaBot.
media_hub.py собирает продолжение просмотра (Jellyfin), заявки и их стадии
(Seerr), очередь загрузок и нехватку (Sonarr/Radarr), место и здоровье служб.
Снимок каждые 30 минут в коллекцию media, в чате — команда «хаб».
Первым прогоном нашёл: «All indexers are unavailable» — медиатека не могла
пополняться. Разобрал цепочку: Prowlarr отдаёт 88 результатов по запросу
matrix, из контейнера Sonarr caps приходит с корректным ключом и 401 с
неверным, тест индексатора в Sonarr и Radarr — 200, health очистился.
Причина — залипший backoff после прошлых ошибок, а не сеть или ключи.
Отдельно зафиксировано: Jackett развёрнут, но индексаторы не включены
(пустые конфиги, API требует cookie); Prowlarr schema зависает, поэтому
добавлять индексаторы можно только из уже имеющейся базы.
resilience_test.py подменяет адреса сервисов на мёртвый порт и проверяет
ответы девяти команд: скорость, отсутствие трассировок, непустой и понятный
текст. Результат: 0 проблемных из 9, все быстрее 0.5 с.
Технические ошибки переведены на человеческий язык (util.human_error):
отказ соединения, таймаут, DNS, нет маршрута, 401/403/404/5xx.
Замечено: часть ответов пришла из кэша util.get — то есть при падении службы
человек получает последнюю известную картину, а не ошибку.
gaps: пять проверок (LLM, Telegram, камеры, MQTT, хранилища) теперь идут
параллельно, результат кэшируется на 60 секунд — библиотеки и Proxmox не
меняются ежесекундно.
Замер 17 команд: было 3.7 с у gaps и одна команда медленнее 3 с, стало
2.5 с на первом вызове и 0.00 с на повторных, медленных нет.
Ловушка: кэш объявлен на уровне модуля; первая вставка «перед классом Bot»
не сработала — бот ответил «Ошибка при gaps». После правок кода ботов нужно
проверять живым вызовом, а не только синтаксисом.
camera_discover.py читает ARP-таблицу и проверяет порты 554/8554/37777/8000/8080
у соседей, сопоставляет MAC с производителями. Ничего не меняет.
Добавлены команды бота: !scan (запустить поиск) и !камеры (статус Frigate
и последний поиск). Результат сохраняется в ядро, коллекция cameras.
Проверено: в сети 31 сосед, камер 0 (порт 554 ни у кого не открыт),
у семи устройств открыты 8080/8000 — это наши контейнеры.
Еженедельный поиск: воскресенье 04:30.
Добавлена проверка реальных пробелов: нет ключа LLM, нет api_id Telegram,
нет камер в Frigate, нет интеграции MQTT в HA, хранилище заполнено от 80%.
Убрано устаревшее утверждение «Frigate не развёрнут» — он развёрнут, камер
нет; теперь это разные вещи и формулируются честно.
Проверено: команда выдаёт пять системных пробелов и пустые библиотеки с
подсказками.
identity_audit.py собирает учётные записи из Authentik, Matrix, Immich,
Paperless, Gitea и Jellyfin, объединяет их по почте или имени (union-find),
отбрасывает служебные аккаунты и строит матрицу «кто где заведён».
Результат: 7 человек. Immich и Paperless есть только у владельца, daniil не
заведён в Matrix. Таблица сохраняется в API (коллекция identity) и отдаётся
ботом по команде !users мгновенно.
Расписание: понедельник 08:00.
По пути: экранирование сломало файл ботов (литеральные \\n) — восстановлен
из репозитория и правка применена заново.
Инфраструктурный бот теперь показывает активность источников событий
(!sources) и историю по сервису (!history kuma). Используются новые
эндпоинты ядра /services и /service/<имя>.
По пути: имя !services уже занято списком служб с адресами, поэтому новые
команды названы !sources; методы пришлось перенести в класс InfraBot
(регистрация и реализация оказались в разных классах).
Проверено: !sources показывает 4 источника с числами, !history kuma —
последние события, !services сохранил прежнее поведение.
Спам прекращён: боты вышли из общих комнат (владельца из них убрали),
состоят только в личной переписке. Писать может только владелец —
остальным вежливый отказ; открывается списком ALLOWED_USERS.
Свободный текст теперь не сваливается в подсказку: если команды нет,
бот сохраняет пожелание во «Входящие» (/var/lib/hub-bots/inbox),
отправляет копию владельцу и отвечает номером записи.
Понимание фраз: к точным командам добавлен разбор по основам слов —
«покажи статистику по медиа» выполняется как stats.
Уведомления (Seerr, тревоги, сводки) переведены из комнат в личку.
Индекс: все семь источников (Jellyfin, Sonarr, Radarr, Navidrome, Calibre,
Paperless, Linkding) в одной базе, пересборка каждые 3 часа. Поиск идёт по
нормализованному полю — SQLite не умеет lower() для кириллицы, поэтому
регистр приводится при сборке. Выгрузки из баз — помощники в контейнерах.
Новые команды: !index (состав индекса), !reindex (пересобрать),
!link (кросс-связи: одно название в разных видах контента),
!gaps (что мешает работать целиком).
Проверено на тестовых записях: «дюна» находится сразу как фильм, книга
и закладка; тестовые записи после проверки удалены.
Восемь ботов в пространстве Buryan Hub, по комнате на домен. Каждый
отвечает на !help списком своих команд и показывает реальные данные:
Jellyfin (Items/Counts), Sonarr/Radarr (очередь, диски, нехватка),
Seerr (заявки), Prometheus (службы, тревоги), Immich/Calibre/Navidrome
и Home Assistant — через pct.
Ежедневная сводка в 09:00 (cron) в комнату «Дайджесты».
Важное: все библиотеки пусты (0 фильмов, 0 фото, 0 книг, 0 треков),
Frigate не развёрнут — боты говорят об этом честно и подсказывают,
как наполнить. Диск один, внешних хранилищ нет.
Секреты: /etc/hub-bots/bots.env (600), /root/hub-bots/ALL-SECRETS.txt (600),
зашифрованная копия ops/secrets-enc/hub-bots-secrets.age.