199 lines
9.1 KiB
Markdown
199 lines
9.1 KiB
Markdown
# ⭐ Auto-Stars-Improved
|
|
|
|
Бот для автоматической отправки Telegram Stars пользователям, которые оставляют посты в указанной теме на форуме Lolz.team.
|
|
|
|
## Возможности
|
|
|
|
- Автоматический мониторинг темы на Lolz.team
|
|
- Отправка Telegram Stars за каждый новый пост
|
|
- Автоматические ответы с поддержкой шаблонов (включая случайный выбор)
|
|
- Автоматическое поднятие темы (bump) с настраиваемым интервалом
|
|
- Система капчи для фильтрации пользователей
|
|
- Поддержка прокси для Telegram и Lolz API (SOCKS5/HTTPS)
|
|
- Полная поддержка Docker (рекомендуется)
|
|
- CI/CD через Gitea Actions (сборка и публикация образов)
|
|
- Уведомления администратору через Telegram
|
|
- Гибкая настройка через `.env`
|
|
- Логирование и сохранение сессии
|
|
- Обработка ошибок и повторные попытки
|
|
|
|
## Требования
|
|
|
|
- Python 3.10+
|
|
- Аккаунт Telegram (для получения `API_ID` и `API_HASH`)
|
|
- API-токен Lolz.team
|
|
- Docker (рекомендуется) или Python окружение
|
|
|
|
## Быстрый старт (Docker — рекомендуется)
|
|
|
|
1. Клонируйте репозиторий:
|
|
|
|
```bash
|
|
git clone https://git.sakamoto.best/Lolz/Auto-Stars-Improved.git
|
|
cd Auto-Stars-Improved
|
|
```
|
|
|
|
2. Скопируйте пример конфигурации:
|
|
|
|
```bash
|
|
cp examples/.env.example .env
|
|
```
|
|
|
|
3. Отредактируйте `.env` и заполните необходимые значения (`API_ID`, `API_HASH`, `LOLZ_TOKEN`, `LOLZ_THREAD_ID` и т.д.).
|
|
|
|
4. Запустите:
|
|
|
|
```bash
|
|
docker compose -f examples/docker-compose.yml up -d
|
|
```
|
|
|
|
5. Посмотрите логи:
|
|
```bash
|
|
docker compose -f examples/docker-compose.yml logs -f
|
|
```
|
|
|
|
## Запуск без Docker
|
|
|
|
```bash
|
|
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 |
|
|
| `START_PAGE` | С какой страницы начинать парсинг | 1 |
|
|
| `ENABLE_REPLY` | Отправлять ли комментарии | true |
|
|
| `SKIP_COMMENTED` | Пропускать посты, на которые уже отвечали | true |
|
|
|
|
### Параметры производительности
|
|
|
|
| Переменная | Описание | По умолчанию |
|
|
| ---------------- | ---------------------------------------- | ------------ |
|
|
| `CHECK_INTERVAL` | Интервал проверки новых постов (секунды) | 10 |
|
|
| `API_DELAY` | Задержка между API запросами (секунды) | 5 |
|
|
| `API_TIMEOUT` | Таймаут для API запросов (секунды) | 15 |
|
|
| `MAX_RETRIES` | Количество повторных попыток при ошибках | 3 |
|
|
|
|
### Уведомления
|
|
|
|
| Переменная | Описание | По умолчанию |
|
|
| -------------- | ------------------------------------------ | ------------ |
|
|
| `BOT_TOKEN` | Токен бота для уведомлений (от @BotFather) | - |
|
|
| `ADMIN_ID` | Telegram ID администратора для уведомлений | - |
|
|
| `NOTIFY_ADMIN` | Включить уведомления администратору | true |
|
|
|
|
### Автоматическое поднятие темы (Bump)
|
|
|
|
| Переменная | Описание | По умолчанию |
|
|
| --------------------- | ------------------------------------- | ------------ |
|
|
| `ENABLE_AUTO_BUMP` | Включить автоматическое поднятие темы | true |
|
|
| `BUMP_CHECK_INTERVAL` | Интервал между поднятиями (секунды) | 3600 |
|
|
|
|
> **Примечание**: Минимальный интервал поднятия — 3600 секунд (1 час) согласно правилам Lolz.team.
|
|
|
|
### Система капчи
|
|
|
|
| Переменная | Описание | По умолчанию |
|
|
| ------------------------ | -------------------------------------------- | ------------ |
|
|
| `ENABLE_CAPTCHA` | Включить систему капчи | false |
|
|
| `CAPTCHA_ANSWER` | Правильный ответ на капчу | - |
|
|
| `CAPTCHA_CHECK_INTERVAL` | Интервал проверки обновления капчи (секунды) | 1800 |
|
|
|
|
Капча добавляется в нижний спойлер первого поста темы: `Капча (обязательно)`.
|
|
|
|
Текст капчи хранится в файле `storage/captcha.txt` и поддерживает BBCode форматирование.
|
|
|
|
**Пример `storage/captcha.txt`:**
|
|
|
|
```
|
|
[CENTER][B]Напишите ответ:[/B]
|
|
сколько будет 20 + 20? [I][COLOR=rgb(80, 80, 78)](Капча меняется раз в месяц)[/COLOR][/I][/CENTER]
|
|
```
|
|
|
|
### Прокси
|
|
|
|
Бот поддерживает использование прокси отдельно для Telegram и Lolz API.
|
|
|
|
| Переменная | Описание | По умолчанию |
|
|
| ---------------- | -------------------------------- | ------------ |
|
|
| `PROXY_TELEGRAM` | Использовать прокси для Telegram | false |
|
|
| `PROXY_LOLZ` | Использовать прокси для Lolz API | false |
|
|
|
|
#### Вариант 1: Единая строка прокси
|
|
|
|
```env
|
|
PROXY=socks5://username:password@host:port
|
|
```
|
|
|
|
Или без авторизации:
|
|
|
|
```env
|
|
PROXY=socks5://host:port
|
|
```
|
|
|
|
#### Вариант 2: Отдельные параметры
|
|
|
|
| Переменная | Описание | По умолчанию |
|
|
| ---------------- | ---------------------------------- | ------------ |
|
|
| `PROXY_PROTOCOL` | Протокол прокси (socks5 или https) | socks5 |
|
|
| `PROXY_HOST` | Хост прокси-сервера | - |
|
|
| `PROXY_PORT` | Порт прокси-сервера | - |
|
|
| `PROXY_USERNAME` | Логин (опционально) | - |
|
|
| `PROXY_PASSWORD` | Пароль (опционально) | - |
|
|
|
|
**Поддерживаемые форматы прокси:**
|
|
|
|
- SOCKS5: `socks5://host:port`
|
|
- HTTPS: `https://host:port`
|
|
|
|
**Поддерживаемые возможности:**
|
|
|
|
- ✓ Пароли с символом `:` внутри
|
|
- ✓ IPv6 адреса
|
|
- ✓ Авторизация с логином и паролем
|
|
- ✓ Независимая настройка для Telegram и Lolz API
|
|
|
|
## Шаблоны ответов
|
|
|
|
Если `ENABLE_REPLY=true`, бот будет отвечать под постами.
|
|
|
|
Шаблоны хранятся в файле `storage/replies.txt`.
|
|
|
|
**Формат:**
|
|
|
|
- Каждая строка — отдельный шаблон
|
|
- Можно использовать `||` для случайного выбора
|
|
|
|
**Пример:**
|
|
|
|
```
|
|
:catdance: Отправил звёзды || :animeyes2: Отправил
|
|
:sadge: Тут может быть реклама
|
|
```
|
|
|
|
Если файл пустой — используется `✓`.
|
|
|
|
## Поддержка
|
|
|
|
- Автор: [Дриада](https://lolz.team/members/7272152/)
|
|
- Создайте Issue на Gitea: https://git.sakamoto.best/Lolz/Auto-Stars-Improved/issues
|
|
- Тема на форуме Lolz.team: https://lolz.team/threads/10187517/
|