Files
buryan-infra/ops/bots
..

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

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

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