Команды истории

Узнайте, какие записи модерации есть у участника на вашем сервере, дайте участникам смотреть собственные записи и стирайте завершённые записи участника, когда он заслужил чистый лист.

Это делают три команды: /history (персонал), /my-history (любой) и /clear-history (персонал, удаляет).

🔎 Посмотреть записи участника: `/history`

Скопируйте ID пользователя Discord участника: в Discord включите Режим разработчика (Developer Mode; Настройки пользователя, Расширенные), нажмите на участника правой кнопкой и выберите Копировать ID пользователя (Copy User ID).
Введите /history, вставьте ID в user_id и нажмите Enter.
Бот отвечает приватно, только вам, последними 10 записями, от новых к старым.

Каждая строка выглядит так:

1. BAN 🔴 (3d) - spamming invites - 2 hours ago #418

тип заглавными буквами (BAN, MUTE, KICK, WARN, SOFTBAN, UNBAN, UNMUTE)
🔴, если запись всё ещё активна
срок в скобках для банов, мутов и софтбанов
причина или «No reason»
когда это произошло
номер дела после #. Именно этот номер нужен для /reason, чтобы изменить формулировку записи.

Чтобы видеть команду, в Discord нужно право Kick Members. Тот же список с большим числом подробностей есть в панели: Модерация → вкладка История, таблица с одной строкой на запись, которую можно фильтровать по типу и по статусу.

🙋 Дать участникам смотреть собственные записи: `/my-history`

Любой может ввести /my-history. Бот приватно покажет ему последние 10 записей модерации, которые сервер хранит о нём. Это быстрый способ разобраться, «за что мне выдали предупреждение?», не отвлекая персонал.

Требуется, чтобы на вашем сервере была включена функция Модерация. Если она выключена, участник получит сообщение об этом.
Настройка Разрешённые роли модераторов игнорируется: никакая роль не нужна.
Если задан префикс текстовых команд, работает и !my-history, но текстовый ответ не может быть приватным: бот публикует его в канале и удаляет через 30 секунд.
Участник без записей получает «You have no moderation records on this server.» (У вас нет записей модерации на этом сервере.)

Личная страница участника в панели, Мои санкции, показывает те же записи со всех серверов.

🧹 Стереть завершённые записи участника: `/clear-history`

/clear-history удаляет все записи участника на вашем сервере, которые больше не активны. Используйте, когда человек отбыл наказание и вы хотите чистое дело.

Убедитесь, что у участника нет ничего активного (см. ниже).
Введите /clear-history, вставьте ID пользователя участника в user_id и нажмите Enter.
Бот ответит Cleared N inactive records for @member или No inactive records found for @member.

Это нельзя отменить. Записи удаляются, а не скрываются.

Что считается неактивным

Запись	Когда становится неактивной
Бан, мут	Когда заканчивается или снят (разбан, снятие мута, истечение срока или Снять в панели)
Предупреждение, софтбан	Только когда модератор удаляет её в панели (Модерация → вкладка История → Удалить на записи). У предупреждения нет даты окончания.
Кик, разбан, снятие мута	Сразу: они уже неактивны в момент записи

Активные записи остаются нетронутыми. Если хотите убрать и предупреждения участника, сначала удалите их в панели, а затем выполните /clear-history.

Кто может это использовать

Должны выполняться все условия:

функция «Модерация» включена на сервере
у человека есть право Ban Members в Discord (обратите внимание: оно выше, чем для /history, которому нужно Kick Members)
если в настройках Модерации задано Разрешённые роли модераторов (слэш-команды), у него должна быть и одна из этих ролей

То же самое в панели

Модерация → вкладка История, затем Очистить всё у любой завершённой (не активной) записи этого участника: нажмите, затем нажмите ещё раз там, где написано Нажмите ещё раз для подтверждения. Будут удалены все завершённые записи участника - то же удаление, что и у команды.

Кнопка в панели записывает строку в Журнал аудита вашего сервера («Cleared N inactive sanction(s)...») и, если задан канал логов модерации, публикует сообщение и там. Команда /clear-history не делает ни того, ни другого: она не оставляет записи в Журнале аудита и ничего не публикует в канале логов. Если вашей команде нужен видимый след, используйте кнопку в панели или напишите строку в канал логов вручную.

💡 Пример

Участник получил два предупреждения в марте и получил мут на сутки в апреле. Сейчас октябрь, и он ведёт себя хорошо.

/history user_id:123456789012345678 показывает: MUTE (1d, без точки, завершён), WARN 🔴, WARN 🔴.
Оба предупреждения всё ещё 🔴, так что одна команда /clear-history удалит только мут.
В панели: Модерация → вкладка История, найдите участника и нажмите Удалить в строке каждого предупреждения.
Теперь /clear-history user_id:123456789012345678. Бот отвечает Cleared 3 inactive records, и дело участника пусто.

🔧 Если что-то пошло не так

🚨 «The Moderation feature is not enabled for this server»

Включите функцию в панели и повторите попытку. В сообщении есть ссылка.

🚨 «You do not have a role that is allowed to use moderation commands on this server»

Ваш сервер ограничивает команды модерации определёнными ролями. Попросите администратора добавить вашу роль в Разрешённые роли модераторов (слэш-команды) или очистить этот список.

🚨 Я не вижу `/clear-history` в списке команд

Discord скрывает её от всех, у кого нет Ban Members. Администратор сервера также может изменить, кто её видит, в Настройки сервера → Интеграции → YAWBDB (Server Settings → Integrations).

🚨 «No inactive records found», но `/history` показывает записи

Записи всё ещё активны. Сначала снимите или удалите их в панели (предупреждения и софтбаны удаляются только вручную).

🚨 «Failed to clear history» или «Server not registered in panel»

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

🚨 Я очистил не того участника

Восстановить нельзя. Воссоздайте записи по собственным заметкам или по Журналу аудита; в Журнале аудита остаётся строка только для очистки, сделанной из панели.

🚨 `/my-history` пишет, что сервер не зарегистрирован

Причина та же, что выше: сервер не подключён к панели.