"""Инструкции ботов: у каждого своя зона ответственности. Это то, что бот присылает человеку при первом обращении — подробно про своё направление, без общей воды. """ 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)