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