Files
buryan-infra/ops/bots
buryan-agent 03d20b95db Агент по графу: понимает вопросы словами, без LLM
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.
2026-10-20 11:39:22 +03:00
..

Флот 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.

В личке команды не нужны: «статистика», «что нового», «найди дюна». В общих комнатах бот отвечает только на !команды, чтобы не мешать разговору.

Роли (на будущее): тип комнаты — естественная граница прав. Личка — полный доступ, общая комната — только чтение и уведомления.