Files
buryan-infra/ops/bots
buryan-agent 681d2a8785 Скорость ботов: параллельные проверки и кэш, медленных команд нет
gaps: пять проверок (LLM, Telegram, камеры, MQTT, хранилища) теперь идут
параллельно, результат кэшируется на 60 секунд — библиотеки и Proxmox не
меняются ежесекундно.

Замер 17 команд: было 3.7 с у gaps и одна команда медленнее 3 с, стало
2.5 с на первом вызове и 0.00 с на повторных, медленных нет.

Ловушка: кэш объявлен на уровне модуля; первая вставка «перед классом Bot»
не сработала — бот ответил «Ошибка при gaps». После правок кода ботов нужно
проверять живым вызовом, а не только синтаксисом.
2026-10-19 21:28:17 +03:00
..

Флот 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.

В личке команды не нужны: «статистика», «что нового», «найди дюна». В общих комнатах бот отвечает только на !команды, чтобы не мешать разговору.

Роли (на будущее): тип комнаты — естественная граница прав. Личка — полный доступ, общая комната — только чтение и уведомления.