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