Как работают команды VibeGuard
Команды VibeGuard выполняются внутри Telegram-группы, в reply-flow, в приватном админском сценарии или через Mini App — в зависимости от функции и настроек конкретного чата.
У каждой Telegram-группы свои настройки: feature flags, доступ к командам, роли модераторов, AI usage, сводки, профили, модерационное состояние и контекст Центра безопасности. Поэтому команда может работать в одной группе и быть недоступной в другой.
Команда обычно не срабатывает по одной из трёх причин:
| Причина | Что проверить |
|---|---|
| Функция выключена | Откройте настройки группы или Центр безопасности. |
| У пользователя нет доступа | Проверьте роль, ранг, Telegram-админство, topic scope или grid scope. |
| У бота нет Telegram-прав | Для удаления, мута, бана, заявок и инвайтов нужны отдельные права. |
Это нормальная защита от сюрпризов. VibeGuard не должен выполнять чувствительные действия только потому, что кто-то написал команду.
Доступ к командам и Telegram-права
Владелец группы может ограничить, кто использует чувствительные команды. Например, один модератор может выдавать варны и муты, другой — только чистить спам по reply, а бан, lockdown, изменение фильтров и доступ к командам могут оставаться у владельца или старших админов.
Доступ может зависеть от:
- роли в VibeGuard;
- Telegram-прав администратора;
- конкретного пользователя;
- topic scope, если группа использует темы;
- grid scope, если настроена сетка чатов;
- включённых feature flags для этой группы.
Telegram-права всё равно важны. Если у VibeGuard нет права удалять сообщения, команда чистки не сможет удалить спам. Если нет права ограничивать участников, мут, кик или бан не применятся. Если нет права работать с заявками, join request workflow не сможет обработать новичка.
Центр безопасности помогает увидеть доступ к командам, missing permissions, audit events и причины, почему действие не сработало.
Команды модерации и чистки
Эти команды нужны, когда в группе нужно быстро остановить флад, убрать спам, выдать предупреждение или разобрать нарушение.
| Зона | Примеры команд | Для чего использовать | Что помнить |
|---|---|---|---|
| Предупреждения | /warn, /warnings, /unwarn | Первый шаг эскалации, повторные нарушения, фиксация причины | Лучше указывать причину и срок действия, если он поддерживается. |
| Муты | /mute, /unmute, /mutes | Временный cooldown при фладе, споре, спаме или нарушении правил | Нужны права ограничения участников. Длительность и причина помогают review. |
| Бан / кик | /ban, /unban, /kick | Удаление спамеров, рейдеров, грубых нарушителей или атакующих | Действие должно быть доступно только доверенным модераторам. |
| Чистка | /purge, /cleanup | Удаление спама, флуда, повторов, следов рейда или reply-диапазона | Крупные чистки лучше делать через preview / dry-run, где это доступно. |
| Кейсы и апелляции | /case, /cases, /appeal | Разбор серьёзных решений, false positives, повторных нарушений | Кейс помогает отделить быстрый response от финального решения. |
| Доступ к командам | /access, /roles, /rank | Управление тем, кто может варнить, мутить, банить, чистить и менять правила | Изменения доступа должны оставаться в журнале. |
Callout для destructive commands: Удаление, мут, кик, бан, purge, lockdown и сетевые действия должны быть доступны только тем, кому владелец группы доверяет. Для таких действий нужны и права VibeGuard, и права Telegram.
Команды безопасности: антиспам, антирейд, проверка новичков
Команды безопасности помогают не только реагировать, но и готовить чат к спаму, рейдам и подозрительным новичкам.
| Зона | Примеры команд / сценариев | Для чего использовать | Что помнить |
|---|---|---|---|
| Антиспам | фильтры ссылок, флуда, медиа, стикеров, edit abuse | Проверять скам-ссылки, repeated link drops, медиа-спам и флад | Начинайте с режима аудита. Удаление включайте после review. |
| Антирейд | raid mode, Watch / Guard / Lockdown / Recovery | Массовый вход, bot waves, invite attacks, first-message bursts | Lockdown не должен быть автоматическим по умолчанию. |
| Новички | капча, заявки, first-message policy, join gate | Проверка новых участников до или сразу после входа | Нужны права на join requests, если используются заявки. |
| Threat review | локальные и сетевые сигналы риска | Скам-паттерны, импостеры, suspicious accounts, повторные нарушения | Сигнал — не приговор. Нужны evidence, review и override. |
| Сетки чатов | grid actions, shared audit, global roles | Общие правила и сигналы для связанных групп | Сетевые действия работают только для opt-in чатов. |
Для антиспама и антирейда лучше начинать с audit-first настройки: VibeGuard показывает, что поймал бы, но не удаляет сообщения и не наказывает участников, пока админы явно не включили действие.
Команды AI/ИИ-сводок, профилей и Telegram AI
Эти команды помогают группе помнить контекст, работать с участниками и использовать AI без превращения публичного чата в поток автоматических ответов.
| Зона | Примеры команд / сценариев | Для чего использовать | Что помнить |
|---|---|---|---|
| AI/ИИ-сводки | recap, daily recap, best-of, voice recap | Понять, что обсуждали за день, какие вопросы важны, что стоит сохранить | Сводки включаются админами и работают в контексте конкретной группы. |
| Профили | /profile, /me, member card | Показать профиль, историю участия, репутацию и group context | Данные профиля scoped к группе и не должны смешиваться с unrelated чатами. |
| Репутация | praise, reputation, rewards | Отметить полезных участников и увидеть вклад | Репутация — сигнал, а не автоматическое право на модерацию. |
| Telegram AI | AI prompt, Mini App AI, image prompts | Подготовить текст, идею, объяснение или изображение | Каждый участник получает до 10 бесплатных AI help/prompts. |
| AI-изображения | image prompt, recent gallery | Создать визуал в Mini App и поделиться вручную | Image usage может учитываться отдельно от текстовых prompts. |
AI-ответы не должны публиковаться в группу автоматически по умолчанию. Пользователь получает результат в controlled workflow, проверяет его и делится только если это полезно и разрешено правилами группы.
Команды музыки, гороскопов и community-модулей
Social-команды должны поддерживать живой чат, но не заменять безопасность и модерацию. Включайте их только там, где это подходит культуре группы.
| Зона | Примеры команд | Для чего использовать | Что помнить |
|---|---|---|---|
| Музыка | /поиск <запрос>, /песня <запрос>, /пост <запрос>, /настройки, /разрешить, /запретить | Найти трек, посмотреть результаты, разрешить или ограничить публикацию | Доступ зависит от настроек группы и прав пользователя. |
| English music aliases | /search, /song, /post, /settings, /allow, /deny | То же, если группа использует English aliases | Русские команды лучше оставить видимыми для /ru/. |
| Гороскоп | гороскоп, знак зодиака, alias или символ знака | Daily ritual и лёгкий повод для обсуждения | Если AI-стилизация недоступна, ответ должен оставаться предсказуемым. |
| Отношения и пары | relationship / pairing flows | Приглашения, пары, карточки, opt-out, social-механики | Подробные relationship-команды лучше держать в отдельной документации. |
| Rewards / награды | reward events, praise, leaderboard | Поддерживать вклад и активность участников | Награды не должны автоматически давать админские права. |
MusicFind действительно поддерживает русские команды /старт, /помощь, /поиск, /пост, /песня, /настройки, /разрешить, /запретить, а также English aliases /start, /help, /search, /post, /song, /settings, /allow, /deny.
Почему команды могут отличаться между группами
VibeGuard — group-scoped бот. Это значит, что команда зависит от того, как настроена конкретная группа.
Команда может быть недоступна, если:
- модуль выключен для этой группы;
- команда доступна только владельцу, админу или модератору;
- в группе не выданы нужные Telegram-права боту;
- команда требует reply, username, ID, duration или reason;
- действие относится к сетке чатов, но сетка ещё не создана;
- команда относится к advanced / opt-in модулю и не должна быть в основном списке;
- AI-квота участника или группы закончилась.
Сначала проверьте Центр безопасности: там проще увидеть feature flags, missing permissions, доступ к командам, audit events и статус группы.
Если команда не работает
Команда ничего не делает. Проверьте, включена ли функция для этой группы и видит ли бот сообщение.
Команда отвечает, что нет доступа. Проверьте роль пользователя, Telegram-админство, rank, topic scope или grid scope.
Команда удаления, мута или бана не применяется. Проверьте Telegram-права бота: удаление сообщений, ограничение участников, join requests или invite links.
Команда требует reply. Некоторые moderation и cleanup flows работают через ответ на сообщение. Попробуйте выполнить команду reply-based.
Команда требует причину или срок. Для варнов, мутов, банов, кейсов и чистки причина помогает review. Для мута часто нужен duration.
Команда относится к другой инструкции. Настройка антиспама, антирейда, AI-квот, проверки новичков и Центра безопасности вынесена в отдельные docs.
FAQ
Какие команды поддерживает VibeGuard?
VibeGuard поддерживает группы команд для модерации, безопасности, AI/ИИ-сводок, профилей, Telegram AI, музыки, гороскопов, репутации и community-функций. Точный набор зависит от включённых функций и прав в конкретной группе.
Почему команда работает в одной группе, но не работает в другой?
Потому что VibeGuard работает по group-scoped настройкам. У каждой группы свои feature flags, доступы, Telegram-права, AI usage, профили и модерационное состояние.
Кто может использовать команды модерации?
Это решают владельцы и админы группы. Доступ может зависеть от роли, ранга, Telegram-прав, named-user exceptions, topic scope и grid scope.
Какие команды опасные?
Удаление, мут, кик, бан, purge, lockdown и сетевые действия требуют особого внимания. Они должны быть доступны только доверенным модераторам и оставлять понятный audit trail.
Есть ли русские команды?
Да. Для русской аудитории важно поддерживать понятную лексику и русские команды там, где они предусмотрены продуктом. Например, музыкальный модуль поддерживает /поиск, /пост, /песня, /настройки, /разрешить, /запретить.
Команды бесплатные?
У VibeGuard есть бесплатная версия навсегда для каждой группы. Каждый участник группы может использовать до 10 бесплатных AI help/prompts. Платное расширение нужно только сверх бесплатного использования или когда группе требуется больше AI-внимания, продвинутые правила безопасности, автоматизация или управление сеткой чатов.
Добавьте VibeGuard в Telegram-группу, включите нужные модули и дайте админам понятные команды без лишней власти.