Личные боты: переписка один на один вместо общей комнаты

Каждый бот теперь личный собеседник: при старте создаёт комнату is_direct
с владельцем и приглашает его. В личке не нужны команды — понимает обычные
слова («статистика», «что нового», «найди дюна»).

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

Боты принимают приглашения: если человек сам начнёт переписку, она станет
личной (признак is_direct в событии приглашения).
This commit is contained in:
buryan-agent committed 2026-10-19 16:53:44 +03:00
1 parent 49f9e7bc89
commit 7b88923550
4 files changed
+224 -29

No files matched your search

+32 -1
View File
@@ -36,7 +36,38 @@
--- ---
## 2. Пространство и комнаты ## 1. Личные боты — основной способ общения
Каждый бот — **личный собеседник**. С ним одна переписка, только вы и он:
| Бот | Что спрашивать |
|---|---|
| `@media` | «статистика», «что нового», «найди дюна», «очередь», «заявки» |
| `@photo` | «статистика», «сколько места» |
| `@book` | «статистика», «новинки», «найди стругацкие» |
| `@home` | «статистика», «состояние» |
| `@infra` | «статус», «тревоги», «место», «бэкапы», «контент», «пробелы», «службы» |
| `@search` | «найди <текст>», «индекс», «связи дюна» |
| `@digest` | «сводка», «карта» |
| `@cam` | «статус» |
В личной переписке **не нужны команды и восклицательные знаки** — пишите
обычными словами. Бот понимает и `!stats`, и «статистика», и «найди дюна».
Комнаты (Медиа, Фото, Книги…) остались как **общие** — там бот отвечает
только на команды с `!`, чтобы не встревать в разговор. Туда же приходят
уведомления и сводки.
Почему так: личка — это «мой помощник», комната — «общая доска».
Когда появится ролевая модель, роль можно вешать на тип комнаты:
личка — полный доступ, общая — только чтение.
Технически: при старте каждый бот создаёт личную комнату с владельцем
(`is_direct`) и приглашает его; карта комнат хранится в
`/etc/hub-bots/dm.env`. Если человек сам начнёт переписку с ботом,
бот примет приглашение и будет отвечать в ней.
## 2. Пространство и общие комнаты
Пространство **Buryan Hub** в Matrix, внутри 9 комнат: Пространство **Buryan Hub** в Matrix, внутри 9 комнат:
+13
View File
@@ -52,3 +52,16 @@ Jellyfin, Sonarr, Radarr, Navidrome, Calibre, Paperless, Linkding.
* `digest.py` — ежедневно в 09:00 (`/etc/cron.d/hub-digest`); * `digest.py` — ежедневно в 09:00 (`/etc/cron.d/hub-digest`);
* `weekly.py` — по понедельникам в 09:30 (`/etc/cron.d/hub-weekly`); * `weekly.py` — по понедельникам в 09:30 (`/etc/cron.d/hub-weekly`);
* `reindex.py` — каждые 3 часа (`/etc/cron.d/hub-index`). * `reindex.py` — каждые 3 часа (`/etc/cron.d/hub-index`).
## Личные боты
Основной режим — переписка один на один. При старте бот создаёт личную
комнату с владельцем (`is_direct`) и приглашает его; карта лежит в
`/etc/hub-bots/dm.env`.
В личке команды не нужны: «статистика», «что нового», «найди дюна».
В общих комнатах бот отвечает только на `!команды`, чтобы не мешать
разговору.
Роли (на будущее): тип комнаты — естественная граница прав. Личка — полный
доступ, общая комната — только чтение и уведомления.
+71 -10
View File
@@ -1,4 +1,4 @@
"""Точка входа: поднимаем всех ботов и слушаем комнаты.""" """Точка входа: поднимаем всех ботов и слушаем личные сообщения."""
import os import os
import signal import signal
import sys import sys
@@ -44,9 +44,64 @@ BOT_CLASSES = {
"CAM": CamBot, "CAM": CamBot,
} }
OWNER = ENV.get("OWNER_USER", "@akadmin:matrix.buryans.ru")
DM_FILE = "/etc/hub-bots/dm.env"
def send_greeting(bot):
bot.mx.send_chunked(bot.room_id, bot.help_text()) def load_dm_map():
"""Личные комнаты, созданные ранее: бот → room_id."""
out = {}
try:
with open(DM_FILE, encoding="utf-8") as f:
for line in f:
if "=" in line and not line.startswith("#"):
k, v = line.strip().split("=", 1)
out[k] = v
except OSError:
pass
return out
def save_dm(prefix, room_id):
try:
existing = load_dm_map()
if existing.get(prefix) == room_id:
return
existing[prefix] = room_id
with open(DM_FILE, "w", encoding="utf-8") as f:
for k, v in sorted(existing.items()):
f.write(f"{k}={v}\n")
os.chmod(DM_FILE, 0o600)
except OSError as e:
print(f"не смог сохранить личку {prefix}: {e}", flush=True)
WELCOME = (
"Привет, я {title}. Можно писать сюда как в обычном чате — без команд "
"и восклицательных знаков: «статистика», «что нового», «найди дюна».\n\n"
"Что умею:\n{commands}\n\n"
"Полный список — «помощь»."
)
def ensure_dm(mx, owner):
"""Личная комната с владельцем: находим существующую или создаём."""
try:
direct = mx.direct_rooms()
if direct:
return sorted(direct)[0]
except Exception:
pass
res = mx.create_dm(owner, name=None)
return res.get("room_id")
def greeting(bot):
text = WELCOME.format(
title=bot.title,
commands="\n".join(f"• {h}" for _, (h, _) in sorted(bot.commands.items())))
# приветствие — в личку, чтобы не засорять общие комнаты
target = next(iter(bot.dm_rooms), None) or bot.room_id
bot.mx.send_chunked(target, text)
def main(): def main():
@@ -58,8 +113,8 @@ def main():
token = ENV.get(f"{prefix}_TOKEN") token = ENV.get(f"{prefix}_TOKEN")
user = ENV.get(f"{prefix}_USER") user = ENV.get(f"{prefix}_USER")
room = ENV.get(f"{prefix}_ROOM") room = ENV.get(f"{prefix}_ROOM")
if not (token and user and room): if not (token and user):
print(f"[{prefix}] пропуск: нет токена/комнаты", flush=True) print(f"[{prefix}] пропуск: нет токена", flush=True)
continue continue
try: try:
mx = Matrix(hs, user, token) mx = Matrix(hs, user, token)
@@ -67,21 +122,27 @@ def main():
if "error" in me: if "error" in me:
print(f"[{prefix}] токен не работает: {me['error']}", flush=True) print(f"[{prefix}] токен не работает: {me['error']}", flush=True)
continue continue
mx.join(room) known = load_dm_map()
bot = cls(mx, room) dm = known.get(prefix) or ensure_dm(mx, OWNER)
if dm:
save_dm(prefix, dm)
dm_rooms = {dm} if dm else set()
if room:
mx.join(room)
bot = cls(mx, room or "", dm_rooms=dm_rooms)
except Exception as e: except Exception as e:
print(f"[{prefix}] ошибка запуска: {e}", flush=True) print(f"[{prefix}] ошибка запуска: {e}", flush=True)
continue continue
bots.append(bot) bots.append(bot)
threading.Thread(target=poll_loop, args=(bot, stop, send_greeting), threading.Thread(target=poll_loop, args=(bot, stop, greeting),
name=f"bot-{prefix.lower()}", daemon=True).start() name=f"bot-{prefix.lower()}", daemon=True).start()
print(f"[{prefix}] запущен: {user} → {room}", flush=True) print(f"[{prefix}] запущен: {user} | личка: {dm or 'нет'}", flush=True)
if not bots: if not bots:
print("ни один бот не запустился", flush=True) print("ни один бот не запустился", flush=True)
return 1 return 1
print(f"готово: {len(bots)} ботов слушают комнаты", flush=True) print(f"готово: {len(bots)} ботов на связи", flush=True)
# приёмник уведомлений от сервисов (Seerr и другие) # приёмник уведомлений от сервисов (Seerr и другие)
try: try:
+108 -18
View File
@@ -73,17 +73,62 @@ class Matrix:
def whoami(self): def whoami(self):
return self._req("GET", "/_matrix/client/v3/account/whoami", timeout=10) 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: class Bot:
"""Бот = учётка + комната + набор команд.""" """Бот = учётка + набор команд. Отвечает в личке и в своей комнате."""
name = "bot" name = "bot"
title = "Бот" title = "Бот"
room_env = "ROOM" room_env = "ROOM"
def __init__(self, mx, room_id): # как люди называют команды обычными словами
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.mx = mx
self.room_id = room_id self.room_id = room_id
self.dm_rooms = set(dm_rooms or [])
self.commands = {} self.commands = {}
self.register() self.register()
@@ -101,31 +146,54 @@ class Bot:
for name, (h, _) in sorted(self.commands.items()): for name, (h, _) in sorted(self.commands.items()):
lines.append(f"• `!{name}` — {h}") lines.append(f"• `!{name}` — {h}")
lines.append("") lines.append("")
lines.append("Команды пишутся в этой комнате. `!help` — эта подсказка.") lines.append("В личной переписке можно без восклицательного знака: "
"просто «статистика» или «найди дюна».")
return "\n".join(lines) return "\n".join(lines)
def dispatch(self, text): def _parse(self, text, in_dm):
"""Разбираем сообщение: команда, псевдоним или свободный текст."""
text = text.strip() text = text.strip()
if not text.startswith("!"): 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 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"): if cmd in ("help", "помощь", "?", "start"):
return self.help_text() return self.help_text()
if cmd not in self.commands: if cmd not in self.commands:
близко = ", ".join(f"`!{c}`" for c in sorted(self.commands)[:6]) близко = ", ".join(f"`!{c}`" for c in sorted(self.commands)[:6])
return f"Не знаю команду `!{cmd}`. Есть: {близко}. Подробнее — `!help`." return f"Не знаю команду `{cmd}`. Есть: {близко}. Подробнее — `!help`."
try: try:
return self.commands[cmd][1](arg) or "Готово." return self.commands[cmd][1](arg) or "Готово."
except Exception as e: except Exception as e:
return f"Ошибка при `!{cmd}`: {str(e)[:200]}" return f"Ошибка при `{cmd}`: {str(e)[:200]}"
def poll_loop(bot, stop_event, on_ready=None): def poll_loop(bot, stop_event, on_ready=None):
"""Длинный опрос: слушаем свою комнату и отвечаем на команды.""" """Слушаем личные комнаты и свою комнату, отвечаем на команды.
В личке понимаем обычные слова («статистика», «найди дюна»),
в общей комнате — только команды с `!`, чтобы не мешать разговору.
"""
since = None since = None
first = True first = True
while not stop_event.is_set(): while not stop_event.is_set():
@@ -137,12 +205,34 @@ def poll_loop(bot, stop_event, on_ready=None):
since = resp.get("next_batch", since) since = resp.get("next_batch", since)
if first: if first:
first = False first = False
# узнаём, какие комнаты сервер считает личными
try:
bot.dm_rooms |= bot.mx.direct_rooms()
except Exception:
pass
if on_ready: if on_ready:
on_ready(bot) on_ready(bot)
continue continue
rooms = resp.get("rooms", {}).get("join", {}) 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(): for rid, data in rooms.items():
if rid != bot.room_id: is_dm = rid in bot.dm_rooms
if rid != bot.room_id and not is_dm:
continue continue
for ev in data.get("timeline", {}).get("events", []): for ev in data.get("timeline", {}).get("events", []):
if ev.get("type") != "m.room.message": if ev.get("type") != "m.room.message":
@@ -150,11 +240,11 @@ def poll_loop(bot, stop_event, on_ready=None):
if ev.get("sender") == bot.mx.user_id: if ev.get("sender") == bot.mx.user_id:
continue continue
body = ev.get("content", {}).get("body", "") body = ev.get("content", {}).get("body", "")
if not body.startswith("!"): if not body:
continue continue
reply = bot.dispatch(body) reply = bot.dispatch(body, in_dm=is_dm)
if reply: if reply:
bot.mx.set_typing(bot.room_id, False) bot.mx.set_typing(rid, False)
bot.mx.send_chunked(bot.room_id, reply) bot.mx.send_chunked(rid, reply)
except Exception: except Exception:
time.sleep(5) time.sleep(5)