Личные боты: переписка один на один вместо общей комнаты
Каждый бот теперь личный собеседник: при старте создаёт комнату is_direct с владельцем и приглашает его. В личке не нужны команды — понимает обычные слова («статистика», «что нового», «найди дюна»). Общие комнаты остались, но там бот отвечает только на !команды, чтобы не встревать в разговор. Уведомления и сводки — туда же. Боты принимают приглашения: если человек сам начнёт переписку, она станет личной (признак is_direct в событии приглашения).
This commit is contained in:
1 parent
49f9e7bc89
commit
7b88923550
4 files changed
+224
-29
No files matched your search
+32
-1
@@ -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 комнат:
|
||||||
|
|
||||||
|
|||||||
@@ -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
@@ -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
@@ -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)
|
||||||
Reference in new issue
Block a user