ALLOWED_USERS расширен: владелец, Полина, Елена, Никита, Сергей, Алекс. Для каждого бота написана подробная инструкция именно по его зоне: медиа (Jellyfin/Seerr/Sonarr/Radarr/Navidrome), фото (Immich), книги (Calibre), дом (HA, Android/Google TV), инфраструктура, поиск, дайджест, камеры. В инструкции — что умеет, примеры человеческих фраз, ссылки и ограничения. Бот присылает инструкцию при первом обращении от человека (один раз, состояние в onboarded.json), «помощь» повторяет её. Проверено: инструкции различаются (610–1249 символов), повторное обращение не спамит, «помощь» отдаёт нужную.
233 lines
12 KiB
Python
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)
|