diff --git a/docs/HUB-BOTS.md b/docs/HUB-BOTS.md index 44da825..85310a0 100644 --- a/docs/HUB-BOTS.md +++ b/docs/HUB-BOTS.md @@ -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 комнат: diff --git a/ops/bots/README.md b/ops/bots/README.md index f54f01a..711becf 100644 --- a/ops/bots/README.md +++ b/ops/bots/README.md @@ -52,3 +52,16 @@ Jellyfin, Sonarr, Radarr, Navidrome, Calibre, Paperless, Linkding. * `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`. + +В личке команды не нужны: «статистика», «что нового», «найди дюна». +В общих комнатах бот отвечает только на `!команды`, чтобы не мешать +разговору. + +Роли (на будущее): тип комнаты — естественная граница прав. Личка — полный +доступ, общая комната — только чтение и уведомления. diff --git a/ops/bots/hub/main.py b/ops/bots/hub/main.py index b602718..47fd795 100644 --- a/ops/bots/hub/main.py +++ b/ops/bots/hub/main.py @@ -1,4 +1,4 @@ -"""Точка входа: поднимаем всех ботов и слушаем комнаты.""" +"""Точка входа: поднимаем всех ботов и слушаем личные сообщения.""" import os import signal import sys @@ -44,9 +44,64 @@ BOT_CLASSES = { "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(): @@ -58,8 +113,8 @@ def main(): token = ENV.get(f"{prefix}_TOKEN") user = ENV.get(f"{prefix}_USER") room = ENV.get(f"{prefix}_ROOM") - if not (token and user and room): - print(f"[{prefix}] пропуск: нет токена/комнаты", flush=True) + if not (token and user): + print(f"[{prefix}] пропуск: нет токена", flush=True) continue try: mx = Matrix(hs, user, token) @@ -67,21 +122,27 @@ def main(): if "error" in me: print(f"[{prefix}] токен не работает: {me['error']}", flush=True) continue - mx.join(room) - bot = cls(mx, room) + known = load_dm_map() + 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: print(f"[{prefix}] ошибка запуска: {e}", flush=True) continue 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() - print(f"[{prefix}] запущен: {user} → {room}", flush=True) + print(f"[{prefix}] запущен: {user} | личка: {dm or 'нет'}", flush=True) if not bots: print("ни один бот не запустился", flush=True) return 1 - print(f"готово: {len(bots)} ботов слушают комнаты", flush=True) + print(f"готово: {len(bots)} ботов на связи", flush=True) # приёмник уведомлений от сервисов (Seerr и другие) try: diff --git a/ops/bots/hub/matrix.py b/ops/bots/hub/matrix.py index 1f40659..5173ce8 100644 --- a/ops/bots/hub/matrix.py +++ b/ops/bots/hub/matrix.py @@ -73,17 +73,62 @@ class Matrix: 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" - 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.room_id = room_id + self.dm_rooms = set(dm_rooms or []) self.commands = {} self.register() @@ -101,31 +146,54 @@ class Bot: for name, (h, _) in sorted(self.commands.items()): lines.append(f"• `!{name}` — {h}") lines.append("") - lines.append("Команды пишутся в этой комнате. `!help` — эта подсказка.") + lines.append("В личной переписке можно без восклицательного знака: " + "просто «статистика» или «найди дюна».") return "\n".join(lines) - def dispatch(self, text): + def _parse(self, text, in_dm): + """Разбираем сообщение: команда, псевдоним или свободный текст.""" 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 - 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`." + return f"Не знаю команду `{cmd}`. Есть: {близко}. Подробнее — `!help`." try: return self.commands[cmd][1](arg) or "Готово." 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): - """Длинный опрос: слушаем свою комнату и отвечаем на команды.""" + """Слушаем личные комнаты и свою комнату, отвечаем на команды. + + В личке понимаем обычные слова («статистика», «найди дюна»), + в общей комнате — только команды с `!`, чтобы не мешать разговору. + """ since = None first = True 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) 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(): - if rid != bot.room_id: + 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": @@ -150,11 +240,11 @@ def poll_loop(bot, stop_event, on_ready=None): if ev.get("sender") == bot.mx.user_id: continue body = ev.get("content", {}).get("body", "") - if not body.startswith("!"): + if not body: continue - reply = bot.dispatch(body) + reply = bot.dispatch(body, in_dm=is_dm) if reply: - bot.mx.set_typing(bot.room_id, False) - bot.mx.send_chunked(bot.room_id, reply) + bot.mx.set_typing(rid, False) + bot.mx.send_chunked(rid, reply) except Exception: time.sleep(5)