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.
Флот Matrix-ботов
Восемь ботов: медиа, фото, книги, дом, инфраструктура, поиск, дайджест, камеры.
Установка
mkdir -p /opt/hub-bots /etc/hub-bots
cp -a hub /opt/hub-bots/
cp digest.py selftest.py /opt/hub-bots/
# настройки: /etc/hub-bots/bots.env (токены ботов, комнаты, ключи сервисов)
systemctl enable --now hub-bots
Служба: /etc/systemd/system/hub-bots.service.
Ежедневная сводка: /etc/cron.d/hub-digest (09:00).
Почему на узле
Боты читают базы сервисов через pct exec (Navidrome, Calibre, Immich,
Home Assistant). Из контейнера в контейнер так не попасть.
Проверка
python3 /opt/hub-bots/selftest.py # ответы ботов без Matrix
systemctl status hub-bots
tail -f /var/log/hub-bots.log
Индекс контента
hub/index.py сводит все сервисы в одну базу (/var/lib/hub-bots/index.db):
Jellyfin, Sonarr, Radarr, Navidrome, Calibre, Paperless, Linkding.
- выгрузки из баз —
hub/helpers/*.py(кладутся в контейнеры в/opt/hub-helpers); - пересборка:
reindex.pyкаждые 3 часа (/etc/cron.d/hub-index); - поиск по нормализованному полю — SQLite не умеет
lower()для кириллицы.
Что показывает состав
!gaps у бота инфраструктуры — честный список того, что мешает системе
работать целиком (пустые библиотеки, нет загрузчика, нет Frigate).
Девять источников индекса
К семи добавлены: immich (альбомы) и seerr (заявки). Выгрузки из баз —
помощники hub/helpers/ (python для Calibre и Linkding, sh+psql для Immich).
Сводки
digest.py— ежедневно в 09:00 (/etc/cron.d/hub-digest);weekly.py— по понедельникам в 09:30 (/etc/cron.d/hub-weekly);reindex.py— каждые 3 часа (/etc/cron.d/hub-index).
Личные боты
Основной режим — переписка один на один. При старте бот создаёт личную
комнату с владельцем (is_direct) и приглашает его; карта лежит в
/etc/hub-bots/dm.env.
В личке команды не нужны: «статистика», «что нового», «найди дюна».
В общих комнатах бот отвечает только на !команды, чтобы не мешать
разговору.
Роли (на будущее): тип комнаты — естественная граница прав. Личка — полный доступ, общая комната — только чтение и уведомления.