Флот 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.
В личке команды не нужны: «статистика», «что нового», «найди дюна».
В общих комнатах бот отвечает только на !команды, чтобы не мешать
разговору.
Роли (на будущее): тип комнаты — естественная граница прав. Личка — полный доступ, общая комната — только чтение и уведомления.