Files
buryan-infra/ops/bots/hub/guides.py
buryan-agent cc7c98dad7 Доступ всем участникам + у каждого бота своя инструкция по направлению
ALLOWED_USERS расширен: владелец, Полина, Елена, Никита, Сергей, Алекс.

Для каждого бота написана подробная инструкция именно по его зоне:
медиа (Jellyfin/Seerr/Sonarr/Radarr/Navidrome), фото (Immich), книги
(Calibre), дом (HA, Android/Google TV), инфраструктура, поиск, дайджест,
камеры. В инструкции — что умеет, примеры человеческих фраз, ссылки и
ограничения.

Бот присылает инструкцию при первом обращении от человека (один раз,
состояние в onboarded.json), «помощь» повторяет её.

Проверено: инструкции различаются (610–1249 символов), повторное
обращение не спамит, «помощь» отдаёт нужную.
2026-10-19 20:10:30 +03:00

233 lines
12 KiB
Python

"""Инструкции ботов: у каждого своя зона ответственности.
Это то, что бот присылает человеку при первом обращении — подробно
про своё направление, без общей воды.
"""
GUIDES = {
"media": {
"title": "Медиа",
"zone": "фильмы, сериалы, музыка: что есть, что качается, что заказать",
"about": (
"Я отвечаю за медиатеку: Jellyfin (что можно смотреть), Seerr "
"(заявки), Sonarr и Radarr (что качается), Navidrome (музыка)."
),
"commands": [
("статистика", "сколько фильмов, сериалов, альбомов в медиатеке"),
("что нового", "что появилось последним"),
("найди <название>", "поиск по медиатеке, например «найди дюна»"),
("сейчас", "кто что смотрит прямо сейчас"),
("очередь", "что стоит в очереди загрузок"),
("заявки", "последние заявки и их статус"),
("место", "сколько свободно на дисках загрузок"),
("не хватает", "сколько серий и фильмов ещё не найдено"),
("куда класть", "пути, куда копировать файлы вручную"),
],
"examples": [
"что нового за неделю",
"найди все части дюны",
"сколько места осталось",
],
"links": [
("Смотреть", "https://media.buryans.ru"),
("Заказать фильм или сериал", "https://ombi.buryans.ru"),
("Что качается", "https://sonarr.buryans.ru"),
],
"rules": [
"Заявку я только покажу — одобряет владелец.",
"Если фильма нет и заказать нельзя — скажу причину (нет источника, нет места).",
"Музыку я считаю, но не качаю: это отдельный процесс.",
],
},
"photo": {
"title": "Фото",
"zone": "фотографии и альбомы в Immich",
"about": (
"Я отвечаю за фотографии: сколько снимков, какие альбомы, сколько "
"занимает хранилище. Источник — Immich."
),
"commands": [
("статистика", "сколько снимков, альбомов и людей"),
("сколько места", "размер базы и хранилища"),
("альбомы", "список альбомов"),
],
"examples": ["сколько у нас фотографий", "какие есть альбомы"],
"links": [
("Открыть фото", "https://immich.buryans.ru"),
("Загрузить с телефона", "приложение Immich, автозагрузка"),
],
"rules": [
"Я не удаляю и не меняю снимки — только показываю.",
"Если снимков нет — напомню, что нужно приложение на телефоне.",
],
},
"book": {
"title": "Книги",
"zone": "библиотека Calibre: что есть, что нового, поиск",
"about": (
"Я отвечаю за книги: сколько их, что появилось последним, найти "
"по названию или автору. Источник — библиотека Calibre."
),
"commands": [
("статистика", "сколько книг в библиотеке"),
("новинки", "последние поступления"),
("найди <название>", "поиск по названию, например «найди стругацкие»"),
],
"examples": ["что нового в библиотеке", "найди пелевин"],
"links": [
("Читать", "https://books.buryans.ru"),
("Каталог", "https://books.buryans.ru/catalog/"),
],
"rules": [
"Я не загружаю книги — это делает человек через сайт.",
"Формат и обложки не правлю.",
],
},
"home": {
"title": "Дом",
"zone": "устройства и датчики Home Assistant (Android-телефоны, Google TV)",
"about": (
"Я отвечаю за умный дом: сколько устройств, какие типы, что "
"происходит. Источник — Home Assistant."
),
"commands": [
("статистика", "сколько устройств и датчиков, по типам"),
("состояние", "краткое состояние дома"),
],
"examples": ["сколько датчиков дома", "что с домом сейчас"],
"links": [
("Панель дома", "https://home.buryans.ru"),
],
"rules": [
"Я показываю состояние, но не управляю устройствами — этим "
"занимается только владелец в приложении.",
"Телефоны на Android и телевизор на Google TV — это тоже "
"устройства дома, я их вижу как сущности.",
],
},
"infra": {
"title": "Инфраструктура",
"zone": "службы, диски, резервные копии, проблемы",
"about": (
"Я отвечаю за то, что вся платформа работает: службы, место на "
"дисках, резервные копии, открытые проблемы и действия сверки."
),
"commands": [
("статус", "какие службы живы, какие нет"),
("тревоги", "активные тревоги"),
("место", "свободное место на узлах"),
("бэкапы", "последние резервные копии"),
("контент", "что лежит в библиотеках"),
("пробелы", "чего не хватает, чтобы всё заработало"),
("службы", "полный список сервисов и адресов"),
("входящие", "пожелания, которые собрали боты"),
],
"examples": ["что сломалось", "сколько места", "что у нас не настроено"],
"links": [
("Мониторинг", "https://status.buryans.ru"),
("Резервные копии", "https://backup.buryans.ru"),
],
"rules": [
"Останавливать и удалять что-либо я не буду без владельца.",
"Если служба не отвечает, скажу, что именно и с какого времени.",
"По ночам сверка сама поднимает остановленные контейнеры.",
],
},
"search": {
"title": "Поиск",
"zone": "поиск по всем сервисам одновременно",
"about": (
"Я ищу сразу везде: в медиатеке, книгах, документах, закладках. "
"Показываю карточку объекта и историю."
),
"commands": [
("найди <текст>", "поиск по всем сервисам"),
("карточка <номер>", "подробности объекта и его история"),
("лента", "последние события системы"),
("связи <текст>", "где встречается одно и то же название"),
],
"examples": ["найди дюна", "карточка 1", "что нового в системе"],
"links": [
("Единая панель", "http://192.168.1.10:9120/"),
],
"rules": [
"Если объекта нет ни в одном сервисе — так и скажу.",
"Номер карточки из поиска нужен для подробностей.",
],
},
"digest": {
"title": "Дайджест",
"zone": "сводки: что произошло за сутки и за неделю",
"about": (
"Я собираю сводку: сколько событий, что скачалось, какие заявки, "
"что сломалось, состояние служб и индекса."
),
"commands": [
("сводка", "итоги за сутки"),
("карта", "какие сервисы есть и за что отвечают"),
],
"examples": ["что было за сутки", "покажи карту платформы"],
"links": [
("Единая панель", "http://192.168.1.10:9120/"),
],
"rules": [
"Сводка приходит сама в 09:00, недельная — по понедельникам 09:30.",
"Я не меняю данные, только рассказываю.",
],
},
"cam": {
"title": "Камеры",
"zone": "видеонаблюдение (Frigate)",
"about": (
"Я отвечаю за камеры: сколько их, что видят, какие события "
"детекции. Сейчас Frigate развёрнут, но камер ещё нет."
),
"commands": [
("статус", "состояние сервера наблюдения и камер"),
],
"examples": ["камеры работают?", "что видно сейчас"],
"links": [
("Frigate (внутренний адрес)", "http://192.168.1.126:5000"),
],
"rules": [
"Пока камер нет, я честно об этом говорю.",
"Записи и детекция включаются после добавления RTSP-адресов.",
],
},
}
def render(bot_name):
"""Полная инструкция бота в человеческом виде."""
g = GUIDES.get(bot_name)
if not g:
return "Инструкция для этого бота пока не написана."
lines = [f"**{g['title']}** — моя зона ответственности", "", g["zone"], "", g["about"], ""]
lines.append("**Что я умею**")
for name, desc in g["commands"]:
lines.append(f"• `{name}` — {desc}")
lines.append("")
lines.append("**Как спросить по-человечески**")
for ex in g["examples"]:
lines.append(f"• «{ex}»")
if g.get("links"):
lines.append("")
lines.append("**Полезные ссылки**")
for label, url in g["links"]:
lines.append(f"• {label}: {url}")
if g.get("rules"):
lines.append("")
lines.append("**Важно**")
for r in g["rules"]:
lines.append(f"• {r}")
lines.append("")
lines.append("Пишите как в обычном чате — команды и восклицательный знак "
"не нужны. Полная инструкция: «помощь».")
return "\n".join(lines)