AntiMichaell/README.md

AntiMichaell

Юзербот на Telethon, который:

• по команде-ответу добавляет пользователя в список автоудаления;
• удаляет его новые сообщения в любых группах только у вас;
• умеет снимать автоудаление (разбан) для конкретного пользователя.

Функции

• Команда бана: /ВБАННАХУЙ (или /ВБАННАХУЙ!, регистр не важен).
• Команда разбана: /РАЗБАН (тоже можно с !).
• Обе команды работают только как reply на сообщение нужного пользователя.
• Список ID хранится в data/blocked_users.json и сохраняется между перезапусками.
• Перед удалением бот всегда пытается поставить реакцию 💩 на сообщение.
• При бане дополнительно чистятся последние сообщения этого пользователя в текущем чате.

Установка

1. Установите Python 3.10+.
2. Создайте и активируйте виртуальное окружение:
   • macOS/Linux:
     • python3 -m venv .venv
     • source .venv/bin/activate
   • Windows (PowerShell):
     • py -m venv .venv
     • .venv\Scripts\Activate.ps1
3. Установите зависимости:
   • pip install -r requirements.txt
4. Создайте .env из примера:
   • cp .env.example .env
5. Заполните .env:
   • API_ID и API_HASH берутся на https://my.telegram.org
   • SESSION_NAME можно оставить по умолчанию.

Запуск

• python bot.py
• При первом запуске Telethon попросит номер телефона, код и при необходимости 2FA-пароль.

Как пользоваться

1. В группе ответьте на сообщение пользователя командой /ВБАННАХУЙ!.
2. Юзербот покажет короткую анимацию и добавит ID пользователя в автоудаление.
3. После бана бот также попробует удалить недавние сообщения этого пользователя в текущем чате.
4. Новые сообщения этого пользователя в группах будут удаляться только у вас.
5. Чтобы отключить автоудаление, ответьте на его сообщение командой /РАЗБАН.

Ограничения

• Удаление "только у вас" работает в формате best effort и зависит от ограничений Telegram API.
• В супергруппах Telegram может не дать локально удалять чужие сообщения без админ-прав.
• Если удаление не удалось из-за прав/ограничений, бот отправит диагностическое уведомление в Избранное.