Files
buryan-infra/ops/bots/hub/matrix.py
T
buryan-agent 91df3e60bf Флот Matrix-ботов: медиа, фото, книги, дом, инфраструктура, поиск, дайджест, камеры
Восемь ботов в пространстве Buryan Hub, по комнате на домен. Каждый
отвечает на !help списком своих команд и показывает реальные данные:
Jellyfin (Items/Counts), Sonarr/Radarr (очередь, диски, нехватка),
Seerr (заявки), Prometheus (службы, тревоги), Immich/Calibre/Navidrome
и Home Assistant — через pct.

Ежедневная сводка в 09:00 (cron) в комнату «Дайджесты».

Важное: все библиотеки пусты (0 фильмов, 0 фото, 0 книг, 0 треков),
Frigate не развёрнут — боты говорят об этом честно и подсказывают,
как наполнить. Диск один, внешних хранилищ нет.

Секреты: /etc/hub-bots/bots.env (600), /root/hub-bots/ALL-SECRETS.txt (600),
зашифрованная копия ops/secrets-enc/hub-bots-secrets.age.
2026-10-19 16:37:38 +03:00

161 lines
5.9 KiB
Python

"""Минимальный клиент Matrix: отправка сообщений и длинный опрос."""
import json
import threading
import time
import urllib.parse
import urllib.request
class Matrix:
def __init__(self, homeserver, user_id, token):
self.hs = homeserver.rstrip("/")
self.user_id = user_id
self.token = token
self.txn = int(time.time() * 1000)
def _req(self, method, path, payload=None, timeout=40):
url = f"{self.hs}{path}"
headers = {"Authorization": f"Bearer {self.token}"}
data = None
if payload is not None:
data = json.dumps(payload).encode()
headers["Content-Type"] = "application/json"
req = urllib.request.Request(url, data=data, headers=headers, method=method)
try:
with urllib.request.urlopen(req, timeout=timeout) as r:
return json.loads(r.read() or b"{}")
except Exception as e:
return {"error": str(e)[:120]}
def send(self, room_id, text, formatted=None):
self.txn += 1
rid = urllib.parse.quote(room_id, safe="")
body = {"msgtype": "m.text", "body": text}
if formatted:
body["format"] = "org.matrix.custom.html"
body["formatted_body"] = formatted
return self._req("PUT", f"/_matrix/client/v3/rooms/{rid}/send/m.room.message/{self.txn}", body)
def send_chunked(self, room_id, text, limit=12000):
"""Matrix режет длинные сообщения — отправляем частями."""
if len(text) <= limit:
return self.send(room_id, text)
parts, buf = [], ""
for line in text.split("\n"):
if len(buf) + len(line) + 1 > limit:
parts.append(buf)
buf = line
else:
buf = f"{buf}\n{line}" if buf else line
if buf:
parts.append(buf)
for i, p in enumerate(parts):
prefix = f"({i + 1}/{len(parts)})\n" if len(parts) > 1 else ""
self.send(room_id, prefix + p)
return {"ok": True}
def set_typing(self, room_id, typing=True, timeout=15000):
rid = urllib.parse.quote(room_id, safe="")
return self._req("PUT", f"/_matrix/client/v3/rooms/{rid}/typing/{self.user_id}",
{"typing": typing, "timeout": timeout}, timeout=8)
def sync(self, since=None, timeout=30000):
params = {"timeout": str(timeout), "filter": json.dumps({"room": {"timeline": {"limit": 20}}})}
if since:
params["since"] = since
q = urllib.parse.urlencode(params)
return self._req("GET", f"/_matrix/client/v3/sync?{q}", timeout=timeout // 1000 + 20)
def join(self, room_id):
rid = urllib.parse.quote(room_id, safe="")
return self._req("POST", f"/_matrix/client/v3/join/{rid}", {})
def whoami(self):
return self._req("GET", "/_matrix/client/v3/account/whoami", timeout=10)
class Bot:
"""Бот = учётка + комната + набор команд."""
name = "bot"
title = "Бот"
room_env = "ROOM"
def __init__(self, mx, room_id):
self.mx = mx
self.room_id = room_id
self.commands = {}
self.register()
def cmd(self, name, help_text):
def deco(fn):
self.commands[name] = (help_text, fn)
return fn
return deco
def register(self):
pass
def help_text(self):
lines = [f"**{self.title}** — что я умею:", ""]
for name, (h, _) in sorted(self.commands.items()):
lines.append(f"• `!{name}` — {h}")
lines.append("")
lines.append("Команды пишутся в этой комнате. `!help` — эта подсказка.")
return "\n".join(lines)
def dispatch(self, text):
text = text.strip()
if not text.startswith("!"):
return None
parts = text[1:].split(None, 1)
if not parts:
return None
cmd = parts[0].lower()
arg = parts[1] if len(parts) > 1 else ""
if cmd in ("help", "помощь", "?", "start"):
return self.help_text()
if cmd not in self.commands:
близко = ", ".join(f"`!{c}`" for c in sorted(self.commands)[:6])
return f"Не знаю команду `!{cmd}`. Есть: {близко}. Подробнее — `!help`."
try:
return self.commands[cmd][1](arg) or "Готово."
except Exception as e:
return f"Ошибка при `!{cmd}`: {str(e)[:200]}"
def poll_loop(bot, stop_event, on_ready=None):
"""Длинный опрос: слушаем свою комнату и отвечаем на команды."""
since = None
first = True
while not stop_event.is_set():
try:
resp = bot.mx.sync(since=since, timeout=25000)
if "error" in resp:
time.sleep(5)
continue
since = resp.get("next_batch", since)
if first:
first = False
if on_ready:
on_ready(bot)
continue
rooms = resp.get("rooms", {}).get("join", {})
for rid, data in rooms.items():
if rid != bot.room_id:
continue
for ev in data.get("timeline", {}).get("events", []):
if ev.get("type") != "m.room.message":
continue
if ev.get("sender") == bot.mx.user_id:
continue
body = ev.get("content", {}).get("body", "")
if not body.startswith("!"):
continue
reply = bot.dispatch(body)
if reply:
bot.mx.set_typing(bot.room_id, False)
bot.mx.send_chunked(bot.room_id, reply)
except Exception:
time.sleep(5)