Lolz/Auto-Stars-Improved
4
0
Fork 0
Code Issues Actions Packages Projects Releases 2 Wiki Activity

Update README with ad support documentation

Browse Source
This commit is contained in:
Open WebUI
2026-09-03 16:18:55 +00:00
parent 751aab1a26
commit 2f9efed5e0
1 changed files with 71 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+71 -44
View File
@@ -16,6 +16,8 @@
- Гибкая настройка через `.env` - Гибкая настройка через `.env`
- Логирование и сохранение сессии - Логирование и сохранение сессии
- Обработка ошибок и повторные попытки - Обработка ошибок и повторные попытки
- **Поддержка рекламы** - автоматическая отправка рекламных сообщений как отдельных комментариев
- **Исправлена обработка `\n`** - теперь корректно обрабатываются многострочные комментарии
## Требования ## Требования
@@ -24,7 +26,7 @@
- API-токен Lolz.team - API-токен Lolz.team
- Docker (рекомендуется) или Python окружение - Docker (рекомендуется) или Python окружение
## Быстрый старт (Docker — рекомендуется) ## Быстрый старт (Docker – рекомендуется)
1. Клонируйте репозиторий: 1. Клонируйте репозиторий:
@@ -73,49 +75,49 @@ python main.py
### Основные параметры ### Основные параметры
| Переменная | Описание | По умолчанию | | Переменная | Описание | По умолчанию |
| --------------------- | ----------------------------------------- | ------------ | | ----------------------- | ------------------------------------------------------------- | ------------ |
| `API_ID` / `API_HASH` | Данные Telegram API | - | | `API_ID` / `API_HASH` | Данные Telegram API | - |
| `LOLZ_TOKEN` | Токен API Lolz.team | - | | `LOLZ_TOKEN` | Токен API Lolz.team | - |
| `LOLZ_THREAD_ID` | ID темы на форуме | - | | `LOLZ_THREAD_ID` | ID темы на форуме | - |
| `STARS_COUNT` | Сколько звёзд отправлять за пост | 1 | | `STARS_COUNT` | Сколько звёзд отправлять за пост | 1 |
| `START_PAGE` | С какой страницы начинать парсинг | 1 | | `START_PAGE` | С какой страницы начинать парсинг | 1 |
| `ENABLE_REPLY` | Отправлять ли комментарии | true | | `ENABLE_REPLY` | Отправлять ли комментарии | true |
| `SKIP_COMMENTED` | Пропускать посты, на которые уже отвечали | true | | `SKIP_COMMENTED` | Пропускать посты, на которые уже отвечали | true |
### Параметры производительности ### Параметры производительности
| Переменная | Описание | По умолчанию | | Переменная | Описание | По умолчанию |
| ---------------- | ---------------------------------------- | ------------ | | ----------------- | ------------------------------------------------- | ------------ |
| `CHECK_INTERVAL` | Интервал проверки новых постов (секунды) | 10 | | `CHECK_INTERVAL` | Интервал проверки новых постов (секунды) | 10 |
| `API_DELAY` | Задержка между API запросами (секунды) | 5 | | `API_DELAY` | Задержка между API запросами (секунды) | 5 |
| `API_TIMEOUT` | Таймаут для API запросов (секунды) | 15 | | `API_TIMEOUT` | Таймаут для API запросов (секунды) | 15 |
| `MAX_RETRIES` | Количество повторных попыток при ошибках | 3 | | `MAX_RETRIES` | Количество повторных попыток при ошибках | 3 |
### Уведомления ### Уведомления
| Переменная | Описание | По умолчанию | | Переменная | Описание | По умолчанию |
| -------------- | ------------------------------------------ | ------------ | | -------------- | --------------------------------------------------------------- | ------------ |
| `BOT_TOKEN` | Токен бота для уведомлений (от @BotFather) | - | | `BOT_TOKEN` | Токен бота для уведомлений (от @BotFather) | - |
| `ADMIN_ID` | Telegram ID администратора для уведомлений | - | | `ADMIN_ID` | Telegram ID администратора для уведомлений | - |
| `NOTIFY_ADMIN` | Включить уведомления администратору | true | | `NOTIFY_ADMIN` | Включить уведомления администратору | true |
### Автоматическое поднятие темы (Bump) ### Автоматическое поднятие темы (Bump)
| Переменная | Описание | По умолчанию | | Переменная | Описание | По умолчанию |
| --------------------- | ------------------------------------- | ------------ | | --------------------- | -------------------------------------------------- | ------------ |
| `ENABLE_AUTO_BUMP` | Включить автоматическое поднятие темы | true | | `ENABLE_AUTO_BUMP` | Включить автоматическое поднятие темы | true |
| `BUMP_CHECK_INTERVAL` | Интервал между поднятиями (секунды) | 3600 | | `BUMP_CHECK_INTERVAL` | Интервал между поднятиями (секунды) | 3600 |
> **Примечание**: Минимальный интервал поднятия — 3600 секунд (1 час) согласно правилам Lolz.team. > **Примечание**: Минимальный интервал поднятия – 3600 секунд (1 час) согласно правилам Lolz.team.
### Система капчи ### Система капчи
| Переменная | Описание | По умолчанию | | Переменная | Описание | По умолчанию |
| ------------------------ | -------------------------------------------- | ------------ | | ----------------------- | ------------------------------------------------------------ | ------------ |
| `ENABLE_CAPTCHA` | Включить систему капчи | false | | `ENABLE_CAPTCHA` | Включить систему капчи | false |
| `CAPTCHA_ANSWER` | Правильный ответ на капчу | - | | `CAPTCHA_ANSWER` | Правильный ответ на капчу | - |
| `CAPTCHA_CHECK_INTERVAL` | Интервал проверки обновления капчи (секунды) | 1800 | | `CAPTCHA_CHECK_INTERVAL`| Интервал проверки обновления капчи (секунды) | 1800 |
Капча добавляется в нижний спойлер первого поста темы: `Капча (обязательно)`. Капча добавляется в нижний спойлер первого поста темы: `Капча (обязательно)`.
@@ -128,14 +130,37 @@ python main.py
сколько будет 20 + 20? [I][COLOR=rgb(80, 80, 78)](Капча меняется раз в месяц)[/COLOR][/I][/CENTER] сколько будет 20 + 20? [I][COLOR=rgb(80, 80, 78)](Капча меняется раз в месяц)[/COLOR][/I][/CENTER]
``` ```
### Реклама
| Переменная | Описание | По умолчанию |
| ------------ | ------------------------------------------------------- | ------------ |
| `ENABLE_ADS` | Включить автоматическую отправку рекламы | false |
Когда `ENABLE_ADS=true`, бот будет автоматически отправлять рекламное сообщение как **отдельный комментарий** после основных ответов.
Текст рекламы хранится в файле `storage/ads.txt`. Файл может содержать BBCode форматирование.
**Пример `storage/ads.txt`:**
```
[ad=align=center][CENTER]PROXYLEET — прокси под работу с аккаунтами и трафиком.
Серверные IPv4 (десятки стран), мобильные, MTProto. От 164 ₽ / 30 дней.
Выдача автоматическая, оплата с баланса лолза.
Промокод LOLZ10 — 10% скидки.
[UNFURL]https://lolz.team/threads/1337[/UNFURL][/CENTER][/ad]
```
> **Примечание**: Реклама отправляется как отдельный комментарий, а не добавляется к основному ответу. По умолчанию `storage/ads.txt` пустой.
### Прокси ### Прокси
Бот поддерживает использование прокси отдельно для Telegram и Lolz API. Бот поддерживает использование прокси отдельно для Telegram и Lolz API.
| Переменная | Описание | По умолчанию | | Переменная | Описание | По умолчанию |
| ---------------- | -------------------------------- | ------------ | | ----------------- | ----------------------------------------- | ------------ |
| `PROXY_TELEGRAM` | Использовать прокси для Telegram | false | | `PROXY_TELEGRAM` | Использовать прокси для Telegram | false |
| `PROXY_LOLZ` | Использовать прокси для Lolz API | false | | `PROXY_LOLZ` | Использовать прокси для Lolz API | false |
#### Вариант 1: Единая строка прокси #### Вариант 1: Единая строка прокси
@@ -151,13 +176,13 @@ PROXY=socks5://host:port
#### Вариант 2: Отдельные параметры #### Вариант 2: Отдельные параметры
| Переменная | Описание | По умолчанию | | Переменная | Описание | По умолчанию |
| ---------------- | ---------------------------------- | ------------ | | ----------------- | ---------------------------------------------- | ------------ |
| `PROXY_PROTOCOL` | Протокол прокси (socks5 или https) | socks5 | | `PROXY_PROTOCOL` | Протокол прокси (socks5 или https) | socks5 |
| `PROXY_HOST` | Хост прокси-сервера | - | | `PROXY_HOST` | Хост прокси-сервера | - |
| `PROXY_PORT` | Порт прокси-сервера | - | | `PROXY_PORT` | Порт прокси-сервера | - |
| `PROXY_USERNAME` | Логин (опционально) | - | | `PROXY_USERNAME` | Логин (опционально) | - |
| `PROXY_PASSWORD` | Пароль (опционально) | - | | `PROXY_PASSWORD` | Пароль (опционально) | - |
**Поддерживаемые форматы прокси:** **Поддерживаемые форматы прокси:**
@@ -179,17 +204,19 @@ PROXY=socks5://host:port
**Формат:** **Формат:**
- Каждая строка — отдельный шаблон - Каждая строка – отдельный шаблон
- Можно использовать `||` для случайного выбора - Можно использовать `||` для случайного выбора
- Поддерживается `\n` для многострочных комментариев
**Пример:** **Пример:**
``` ```
:catdance: Отправил звёзды || :animeyes2: Отправил :catdance: Отправил звёзды || :animeyes2: Отправил
:sadge: Тут может быть реклама :sadge: Тут может быть реклама
Первая строка\nВторая строка\nТретья строка
``` ```
Если файл пустой — используется `✓`. Если файл пустой – используется `✓`.
## Поддержка ## Поддержка