⭐ Auto-Stars-Improved

Бот для автоматической отправки Telegram Stars пользователям, которые оставляют посты в указанной теме на форуме Lolz.team.

Возможности

• Автоматический мониторинг темы на Lolz.team
• Отправка Telegram Stars за каждый новый пост
• Автоматические ответы с поддержкой шаблонов (включая случайный выбор)
• Полная поддержка Docker (рекомендуется)
• CI/CD через Gitea Actions (сборка и публикация образов)
• Уведомления администратору через Telegram
• Гибкая настройка через .env
• Логирование и сохранение сессии

Требования

• Python 3.10+
• Аккаунт Telegram (для получения API_ID и API_HASH)
• API-токен Lolz.team
• Docker (рекомендуется) или Python окружение

Быстрый старт (Docker — рекомендуется)

1. Клонируйте репозиторий:

   git clone https://git.sakamoto.best/Lolz/Auto-Stars-Improved.git
   cd Auto-Stars-Improved
   

2. Скопируйте пример конфигурации:

   cp examples/.env.example .env
   

3. Отредактируйте .env и заполните необходимые значения (API_ID, API_HASH, LOLZ_TOKEN, LOLZ_THREAD_ID и т.д.).

4. Запустите:

   docker compose -f examples/docker-compose.yml up -d
   

5. Посмотрите логи:

   docker compose -f examples/docker-compose.yml logs -f
   

Запуск без Docker

pip install -r requirements.txt
cp examples/.env.example .env
# отредактируйте .env
python main.py

При первом запуске (если используете Pyrogram напрямую) потребуется интерактивная авторизация в Telegram.

Конфигурация

Все настройки находятся в файле .env.

Пример конфигурации лежит здесь:

• examples/.env.example

Основные параметры:

Переменная	Описание	По умолчанию
API_ID / API_HASH	Данные Telegram API	-
LOLZ_TOKEN	Токен API Lolz.team	-
LOLZ_THREAD_ID	ID темы на форуме	-
STARS_COUNT	Сколько звёзд отправлять за пост	1
DEFAULT_CHOICE	1 — реал-тайм, 2 — обработать все посты	2
ENABLE_REPLY	Отправлять ли комментарии	true
SKIP_COMMENTED	Пропускать посты, на которые уже отвечали	true

Шаблоны ответов

Если ENABLE_REPLY=true, бот будет отвечать под постами.

Шаблоны хранятся в файле storage/replies.txt.

Формат:

• Каждая строка — отдельный шаблон
• Можно использовать || для случайного выбора

Пример:

:catdance: Отправил звёзды || :animeyes2: Отправил
:sadge: Тут может быть реклама

Если файл пустой — используется ✓.