Каждый бот теперь личный собеседник: при старте создаёт комнату is_direct с владельцем и приглашает его. В личке не нужны команды — понимает обычные слова («статистика», «что нового», «найди дюна»). Общие комнаты остались, но там бот отвечает только на !команды, чтобы не встревать в разговор. Уведомления и сводки — туда же. Боты принимают приглашения: если человек сам начнёт переписку, она станет личной (признак is_direct в событии приглашения).
11 KiB
Buryan Hub: флот ботов и контентная платформа
Что сделано 19.10.2026: боты в Matrix, пространство с комнатами, единая карта сервисов, ежедневная сводка, ключи в одном месте.
1. Важное открытие: библиотеки пусты
Прежде чем строить «контентную архитектуру», проверил, что в сервисах есть:
| Сервис | Содержимое |
|---|---|
| Jellyfin (медиатека) | 0 фильмов, 0 сериалов, 0 серий, 0 альбомов |
| Plex | папка /opt/plex/media пуста |
| Navidrome (музыка) | 0 треков, 0 альбомов |
| Immich (фото) | 0 снимков, 0 альбомов |
| Calibre (книги) | 0 книг |
| Home Assistant | 8 сущностей |
| Frigate | не развёрнут |
Диск один (NVMe 476 ГБ), внешних хранилищ нет. То есть платформа построена, но контентом не наполнена — интеграция пока показывает честные нули и подсказки, как наполнить.
Что нужно, чтобы ожило:
- Медиа — положить файлы в
/media/movies,/media/series,/media/music(CT 103) и запустить сканирование. Для автоматических загрузок — настроить в Sonarr/Radarr клиент загрузки (qBittorrent/ Transmission) и индексаторы в Prowlarr. - Фото — поставить приложение Immich на телефоны, включить автозагрузку.
- Книги — загрузить через
books.buryans.ru. - Дом — добавить устройства в Home Assistant.
- Frigate — нужны RTSP-адреса камер; без них сервер наблюдения не имеет смысла.
1. Личные боты — основной способ общения
Каждый бот — личный собеседник. С ним одна переписка, только вы и он:
| Бот | Что спрашивать |
|---|---|
@media |
«статистика», «что нового», «найди дюна», «очередь», «заявки» |
@photo |
«статистика», «сколько места» |
@book |
«статистика», «новинки», «найди стругацкие» |
@home |
«статистика», «состояние» |
@infra |
«статус», «тревоги», «место», «бэкапы», «контент», «пробелы», «службы» |
@search |
«найди <текст>», «индекс», «связи дюна» |
@digest |
«сводка», «карта» |
@cam |
«статус» |
В личной переписке не нужны команды и восклицательные знаки — пишите
обычными словами. Бот понимает и !stats, и «статистика», и «найди дюна».
Комнаты (Медиа, Фото, Книги…) остались как общие — там бот отвечает
только на команды с !, чтобы не встревать в разговор. Туда же приходят
уведомления и сводки.
Почему так: личка — это «мой помощник», комната — «общая доска». Когда появится ролевая модель, роль можно вешать на тип комнаты: личка — полный доступ, общая — только чтение.
Технически: при старте каждый бот создаёт личную комнату с владельцем
(is_direct) и приглашает его; карта комнат хранится в
/etc/hub-bots/dm.env. Если человек сам начнёт переписку с ботом,
бот примет приглашение и будет отвечать в ней.
2. Пространство и общие комнаты
Пространство Buryan Hub в Matrix, внутри 9 комнат:
| Комната | Бот | Что там |
|---|---|---|
| Медиа | @media |
фильмы, сериалы, очередь загрузок, заявки |
| Фото | @photo |
Immich: снимки, альбомы |
| Книги | @book |
библиотека, поиск, новинки |
| Дом | @home |
Home Assistant: сущности, состояние |
| Инфраструктура | @infra |
службы, тревоги, диски, резервные копии, состав библиотек |
| Поиск | @search |
поиск по медиа, книгам и документам сразу |
| Дайджесты | @digest |
ежедневная сводка в 09:00 и карта платформы |
| Камеры | @cam |
Frigate (когда появится) |
Люди приглашены: @akadmin, @polina, @elena, @nikita, @sergey, @alextest.
3. Команды ботов
У каждого бота !help показывает свои команды. Коротко:
| Бот | Команды |
|---|---|
| media | !stats !new !find <текст> !now !queue !requests !disk !wanted !paths |
| photo | !stats !space |
| book | !stats !new !find <текст> |
| home | !stats !status |
| infra | !status !alerts !disk !backups !content !services !gaps |
| search | !s <текст> !index !reindex !link <текст> |
| digest | !digest !map |
| cam | !status |
Отдельно стоит знать:
!gaps— честный список того, что мешает системе работать целиком: пустые библиотеки, не настроенный загрузчик, отсутствие Frigate. Это ответ на вопрос «что у нас есть и чего не хватает» без прикрас.!index— что попало в общий индекс и когда он обновлялся.!link— кросс-связи: где одно и то же название встречается в разных видах контента (фильм, книга, закладка).
3.1. Общий индекс контента
Все сервисы сведены в одну базу /var/lib/hub-bots/index.db:
| Источник | Что забирает |
|---|---|
| Jellyfin | фильмы, сериалы, треки |
| Sonarr / Radarr | сериалы и фильмы (в том числе ещё не скачанные) |
| Navidrome | альбомы и исполнители |
| Calibre | книги и авторов |
| Paperless | документы |
| Linkding | закладки |
Особенности:
- поиск идёт по нормализованному полю — SQLite не умеет
lower()для кириллицы, поэтому регистр приводится в Python при сборке; - выгрузки из баз делают маленькие помощники
hub/helpers/*.py, они лежат в контейнерах (/opt/hub-helpers); - пересборка — каждые 3 часа (
/etc/cron.d/hub-index) и командой!reindex; при недоступности источника в комнату дайджеста уходит предупреждение.
Проверено на тестовых записях: поиск «дюна» находит фильм, книгу и закладку
одной командой, !link группирует их по видам.
4. Как это устроено
/opt/hub-bots/ ← код на узле Proxmox
hub/
matrix.py клиент Matrix: отправка, длинный опрос
sources.py клиенты сервисов (Jellyfin, Sonarr, Radarr, Seerr, Prometheus)
local.py чтение баз через pct (Navidrome, Calibre, Immich, HA)
catalog.py карта сервисов и состав библиотек
bots.py все боты и их команды
main.py запуск флота
digest.py ежедневная сводка (cron 09:00)
/etc/hub-bots/bots.env настройки и ключи (600)
/etc/systemd/system/hub-bots.service
Почему на узле, а не в контейнере: боты читают базы сервисов через pct exec
(Navidrome, Calibre, Immich, Home Assistant) — из контейнера так нельзя.
Служба: systemctl status hub-bots, лог /var/log/hub-bots.log.
5. Где ключи
/etc/hub-bots/bots.env— рабочие ключи (600)./root/hub-bots/ALL-SECRETS.txt— все ключи одним файлом (600).ops/secrets-enc/hub-bots-secrets.age— то же, зашифровано age (в репозитории). Расшифровать:SOPS_AGE_KEY_FILE=/root/.buryan-age-key sops -d ....
6. Уведомления из сервисов
Боты принимают вебхуки и публикуют их в комнате «Медиа»:
- приёмник:
http://192.168.1.10:9110/seerr(внутри службы ботов); - в Seerr настроено: заявка создана, одобрена, отклонена, стала доступна, одобрена автоматически (маска событий 206);
- проверено: уведомление «Уже доступно — Дюна: часть вторая (2024), просил Роман» пришло в комнату.
Чтобы добавить ещё сервис — шлите POST на тот же адрес с полем
notification_type, либо на /other (придёт как есть).
7. Seerr без пароля: Quick Connect
В Seerr включён быстрый вход: POST /api/v1/auth/jellyfin/quickconnect/initiate
возвращает код, человек вводит его в Jellyfin (где уже вошёл через Authentik)
и попадает в Seerr без пароля.
Важно: при первом входе Seerr очистил адрес Jellyfin в настройках —
из-за этого быстрый вход падал с «Invalid URL». Адрес прописан заново
(192.168.1.103:8096), после чего код выдаётся.
8. Что дальше (по приоритету)
- Наполнить библиотеки — без контента боты показывают нули.
- Уведомления Seerr/Sonarr → комната «Медиа» (вебхук в n8n или напрямую).
- Frigate — как только будут камеры.
- Кросс-связи: книга → экранизация (Calibre ↔ Jellyfin), фото → место (Immich ↔ Home Assistant), музыка → исполнитель в медиатеке.
- Утренняя сводка уже включена — посмотрите комнату «Дайджесты».