Files
buryan-infra/ops/bots/README.md
buryan-agent 7b88923550 Личные боты: переписка один на один вместо общей комнаты
Каждый бот теперь личный собеседник: при старте создаёт комнату is_direct
с владельцем и приглашает его. В личке не нужны команды — понимает обычные
слова («статистика», «что нового», «найди дюна»).

Общие комнаты остались, но там бот отвечает только на !команды, чтобы не
встревать в разговор. Уведомления и сводки — туда же.

Боты принимают приглашения: если человек сам начнёт переписку, она станет
личной (признак is_direct в событии приглашения).
2026-10-19 16:53:44 +03:00

68 lines
3.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Флот 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`.
В личке команды не нужны: «статистика», «что нового», «найди дюна».
В общих комнатах бот отвечает только на `!команды`, чтобы не мешать
разговору.
Роли (на будущее): тип комнаты — естественная граница прав. Личка — полный
доступ, общая комната — только чтение и уведомления.