Документация — gated/noindex страница для advanced opt-in RP-модуля
Техническая документация

Advanced opt-in RP модуль VibeGuard для админов

Эта страница для владельцев и senior-админов, которые осознанно проверяют advanced opt-in RP-модуль VibeGuard. Модуль выключен по умолчанию, включается только на уровне конкретной группы и требует понимания доступа, приватности, модерации и культуры сообщества.

Прочитайте перед включением RP

VibeGuard в первую очередь — бот для безопасности, модерации, AI/ИИ-сводок и управления Telegram-группами. Advanced RP — отдельный чувствительный opt-in модуль для групп, которые сознательно выбирают такой формат взаимодействия.

Не включайте его во время обычного онбординга. Не включайте его только потому, что в группе активны отношения, пары, валентинки или другие social-функции. RP-доступ — отдельное решение.

Безопасный дефолт простой: оставить модуль выключенным, пока владелец группы не проверил настройки, не понял аудиторию и не готов отвечать за культуру чата.

Предварительные условия

Перед включением advanced opt-in RP проверьте, что у группы есть понятные правила, активные модераторы и админ, который отвечает за настройку доступа.

Минимально стоит подготовить:

  • решение владельца или senior-админа о включении;
  • отдельный feature flag для RP;
  • ограничение доступа по роли, рангу или trusted-статусу;
  • age/access gate там, где это применимо;
  • cooldowns против флуда;
  • план отключения, если функция создаёт спам, давление или конфликт.

Если хотя бы один пункт не готов, лучше оставить модуль выключенным.

Как модуль работает на высоком уровне

Advanced RP-модуль распознаёт заранее настроенные RP-триггеры в сообщениях Telegram-группы. Когда срабатывание допустимо, VibeGuard определяет целевого участника, применяет cooldowns и правила привилегий, а затем возвращает случайный outcome-сценарий.

Определение цели должно начинаться с reply-контекста: если участник отвечает на сообщение другого участника, это самый понятный способ выбрать цель. Если reply нет, модуль может использовать поддерживаемые ссылки на пользователя: username, текстовое упоминание или локальный lookup известного участника группы.

Модуль должен отклонять недопустимые цели там, где это требуется: например, случайное самонаведение, target на бота или непонятное упоминание. Это снижает риск случайных срабатываний и мусора в чате.

Explicit-trigger каталог не публикуется на этой странице.

Что контролируют админы

Админы решают, доступен ли RP-модуль в конкретной Telegram-группе. Если feature flag выключен, связанные команды, Mini App-экраны и действия должны быть скрыты или заблокированы.

Админские настройки должны покрывать статус feature flag, требования доступа, age/access gate, cooldowns, привилегии, доступность voice artifacts, видимость в Mini App и возможность отключения или сброса.

Начинайте с самого узкого доступа. Например, только владелец, senior-админы или trusted-участники. Расширяйте доступ только если группа действительно понимает формат и модераторы готовы разбирать спорные случаи.

Cooldowns, привилегии и voice artifacts

Обычные участники должны попадать под cooldowns, чтобы RP-модуль не превращал чат во флад. Для админов или привилегированных рангов могут быть другие правила, если группа намеренно это разрешает.

Некоторые action-категории могут быть настроены как всегда успешные, а другие — как случайные outcomes: успех, усиленный успех или неудача. На публичной странице это стоит объяснять только на уровне механики, без каталога фраз и примеров sensitive-ответов.

Модуль может прикреплять заранее настроенные voice artifacts, если такая доставка включена. Админам нужно относиться к таким артефактам как к чувствительному внешнему контенту: понимать, где они хранятся, как отключаются и как удаляются при запросе на удаление данных, если это применимо к текущей конфигурации.

Приватность, логи и границы контента

Группа остаётся основным tenant: настройки, доступы, RP-состояние и связанные записи должны быть привязаны к конкретному chat_id. Включение RP в одной группе не означает включение в другой.

Логи не должны хранить лишний sensitive-контент. Для операций, abuse review и поддержки достаточно минимальных служебных данных: факт срабатывания, настройка, участник, результат, время и нужный контекст без публикации explicit-содержимого.

RP-модуль не должен ослаблять модерацию. Если правило безопасности блокирует нарушение после явного включения такого правила админом, safety остаётся выше social-механики. Варны, муты, баны, чистка, кейсы и апелляции должны работать независимо от RP-настроек.

Как включать безопасно

Рекомендуемый порядок настройки:

  1. Проверьте, что группа действительно подходит для такого формата.
  2. Откройте доступ только владельцу или senior-админам.
  3. Включите feature flag на уровне конкретной группы.
  4. Настройте age/access gate и cooldowns.
  5. Проверьте, что Mini App и команды видны только тем, кому разрешены.
  6. Наблюдайте за использованием и отключите модуль при первых признаках спама, давления или конфликта.

Не включайте модуль массово в сетке чатов. Если у вас несколько групп, каждая должна принимать это решение отдельно.

Ожидаемый результат

После настройки админы должны понимать:

  • модуль выключен по умолчанию;
  • нужен явный group-level opt-in;
  • доступы и age/access gate критичны;
  • cooldowns помогают снизить флад;
  • explicit-trigger каталог не публикуется здесь;
  • логи должны быть минимизированы;
  • модуль можно оставить выключенным без потери основных функций VibeGuard.

Основная ценность VibeGuard остаётся прежней: безопасность, модерация, AI/ИИ-сводки, Центр безопасности и обычные community-модули.

Troubleshooting

RP-триггеры не работают в группе. Проверьте, включён ли feature flag, есть ли у пользователя нужный доступ и соответствует ли сообщение настроенным паттернам. Не публикуйте trigger-каталог в общий чат.

Участник случайно активировал RP. Сузьте паттерны, повысьте требования доступа, увеличьте cooldowns или выключите модуль.

RP-сообщения создают флад. Увеличьте cooldowns, ограничьте доступ trusted-участниками или полностью отключите feature flag.

Voice artifact не должен быть доступен. Отключите доставку voice artifacts для модуля и проверьте lifecycle внешних артефактов.

Модуль появился там, где его не должно быть. Проверьте feature flags, видимость Mini App, command routing и настройки конкретной группы. Выключенные функции должны быть скрыты или заблокированы.

FAQ

Advanced opt-in RP включён по умолчанию?

Нет. Этот модуль должен быть выключен по умолчанию и требовать явного включения админом на уровне конкретной группы.

Это часть обычной настройки VibeGuard?

Нет. Обычная настройка должна начинаться с безопасности, модерации, AI/ИИ-сводок, Центра безопасности и тех community-функций, которые подходят большинству групп.

Будут ли здесь опубликованы RP-trigger фразы?

Нет. Каталог sensitive-триггеров не должен дублироваться в широкой документации. Он относится к контролируемой конфигурации или закрытым админским материалам.

Можно ли ограничить, кто использует RP-функции?

Да. Доступ должен контролироваться feature flag, ролью или рангом, cooldowns и age/access gate там, где это применимо.

VibeGuard остаётся бесплатным, если RP выключен?

Да. У VibeGuard есть бесплатная версия навсегда для каждой Telegram-группы. Каждый участник группы также может использовать до 10 AI help/prompts бесплатно; расширение нужно только сверх бесплатного использования или для продвинутых потребностей.

Держите advanced RP выключенным, если группа не выбирает его осознанно и админы не готовы контролировать использование.