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

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

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

251 lines
10 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)
def create_dm(self, user_id, name=None):
"""Создаём личную комнату с человеком и приглашаем его."""
payload = {
"is_direct": True,
"preset": "trusted_private_chat",
"invite": [user_id],
}
if name:
payload["name"] = name
return self._req("POST", "/_matrix/client/v3/createRoom", payload, timeout=25)
def direct_rooms(self):
"""Что сервер считает личными комнатами (m.direct)."""
data = self._req("GET", "/_matrix/client/v3/user/" + urllib.parse.quote(self.user_id, safe="")
+ "/account_data/m.direct", timeout=10)
rooms = set()
if isinstance(data, dict):
for ids in data.values():
if isinstance(ids, list):
rooms.update(ids)
return rooms
class Bot:
"""Бот = учётка + набор команд. Отвечает в личке и в своей комнате."""
name = "bot"
title = "Бот"
room_env = "ROOM"
# как люди называют команды обычными словами
ALIASES = {
"статистика": "stats", "стата": "stats", "сколько": "stats",
"новое": "new", "новинки": "new", "что нового": "new", "последнее": "new",
"поиск": "find", "найди": "find", "ищи": "find",
"сейчас": "now", "смотрят": "now",
"очередь": "queue", "закачки": "queue",
"заявки": "requests", "запросы": "requests",
"диск": "disk", "место": "disk",
"нехватка": "wanted", "не хватает": "wanted",
"файлы": "paths", "пути": "paths",
"карта": "map", "сводка": "digest", "дайджест": "digest",
"пробелы": "gaps", "чего не хватает": "gaps",
"службы": "services", "сервисы": "services",
"содержимое": "content", "контент": "content",
"тревоги": "alerts", "бэкапы": "backups", "бэкап": "backups",
"состояние": "status", "статус": "status",
"индекс": "index", "связи": "link",
"пространство": "space", "альбомы": "stats",
"помощь": "help", "команды": "help", "help": "help",
}
def __init__(self, mx, room_id, dm_rooms=None):
self.mx = mx
self.room_id = room_id
self.dm_rooms = set(dm_rooms or [])
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("В личной переписке можно без восклицательного знака: "
"просто «статистика» или «найди дюна».")
return "\n".join(lines)
def _parse(self, text, in_dm):
"""Разбираем сообщение: команда, псевдоним или свободный текст."""
text = text.strip()
if not text:
return None, ""
if text.startswith("!"):
parts = text[1:].split(None, 1)
return parts[0].lower(), (parts[1] if len(parts) > 1 else "")
if not in_dm:
return None, ""
# в личке понимаем обычные слова
low = text.lower().rstrip("?!.")
if low in self.ALIASES:
return self.ALIASES[low], ""
if low in self.commands:
return low, ""
first, _, rest = text.partition(" ")
if first.lower() in self.ALIASES:
return self.ALIASES[first.lower()], rest.strip()
if first.lower() in self.commands:
return first.lower(), rest.strip()
return "help", ""
def dispatch(self, text, in_dm=False):
cmd, arg = self._parse(text, in_dm)
if not cmd:
return None
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
# узнаём, какие комнаты сервер считает личными
try:
bot.dm_rooms |= bot.mx.direct_rooms()
except Exception:
pass
if on_ready:
on_ready(bot)
continue
rooms = resp.get("rooms", {}).get("join", {})
# нас пригласили — заходим; личкой считаем только прямые приглашения
for rid, invite in (resp.get("rooms", {}).get("invite") or {}).items():
try:
bot.mx.join(rid)
is_direct = False
for ev in (invite.get("invite_state", {}) or {}).get("events", []):
if (ev.get("type") == "m.room.member"
and ev.get("content", {}).get("is_direct")):
is_direct = True
break
if is_direct:
bot.dm_rooms.add(rid)
except Exception:
pass
for rid, data in rooms.items():
is_dm = rid in bot.dm_rooms
if rid != bot.room_id and not is_dm:
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:
continue
reply = bot.dispatch(body, in_dm=is_dm)
if reply:
bot.mx.set_typing(rid, False)
bot.mx.send_chunked(rid, reply)
except Exception:
time.sleep(5)