diff --git a/README.md b/README.md index bbd78b9..e16ee7b 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,8 @@ - Гибкая настройка через `.env` - Логирование и сохранение сессии - Обработка ошибок и повторные попытки +- **Поддержка рекламы** - автоматическая отправка рекламных сообщений как отдельных комментариев +- **Исправлена обработка `\n`** - теперь корректно обрабатываются многострочные комментарии ## Требования @@ -24,7 +26,7 @@ - API-токен Lolz.team - Docker (рекомендуется) или Python окружение -## Быстрый старт (Docker — рекомендуется) +## Быстрый старт (Docker – рекомендуется) 1. Клонируйте репозиторий: @@ -73,49 +75,49 @@ python main.py ### Основные параметры -| Переменная | Описание | По умолчанию | -| --------------------- | ----------------------------------------- | ------------ | -| `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 | +| Переменная | Описание | По умолчанию | +| ----------------------- | ------------------------------------------------------------- | ------------ | +| `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 | +| Переменная | Описание | По умолчанию | +| ----------------- | ------------------------------------------------- | ------------ | +| `CHECK_INTERVAL` | Интервал проверки новых постов (секунды) | 10 | +| `API_DELAY` | Задержка между API запросами (секунды) | 5 | +| `API_TIMEOUT` | Таймаут для API запросов (секунды) | 15 | +| `MAX_RETRIES` | Количество повторных попыток при ошибках | 3 | ### Уведомления -| Переменная | Описание | По умолчанию | -| -------------- | ------------------------------------------ | ------------ | -| `BOT_TOKEN` | Токен бота для уведомлений (от @BotFather) | - | -| `ADMIN_ID` | Telegram ID администратора для уведомлений | - | -| `NOTIFY_ADMIN` | Включить уведомления администратору | true | +| Переменная | Описание | По умолчанию | +| -------------- | --------------------------------------------------------------- | ------------ | +| `BOT_TOKEN` | Токен бота для уведомлений (от @BotFather) | - | +| `ADMIN_ID` | Telegram ID администратора для уведомлений | - | +| `NOTIFY_ADMIN` | Включить уведомления администратору | true | ### Автоматическое поднятие темы (Bump) -| Переменная | Описание | По умолчанию | -| --------------------- | ------------------------------------- | ------------ | -| `ENABLE_AUTO_BUMP` | Включить автоматическое поднятие темы | true | -| `BUMP_CHECK_INTERVAL` | Интервал между поднятиями (секунды) | 3600 | +| Переменная | Описание | По умолчанию | +| --------------------- | -------------------------------------------------- | ------------ | +| `ENABLE_AUTO_BUMP` | Включить автоматическое поднятие темы | true | +| `BUMP_CHECK_INTERVAL` | Интервал между поднятиями (секунды) | 3600 | -> **Примечание**: Минимальный интервал поднятия — 3600 секунд (1 час) согласно правилам Lolz.team. +> **Примечание**: Минимальный интервал поднятия – 3600 секунд (1 час) согласно правилам Lolz.team. ### Система капчи -| Переменная | Описание | По умолчанию | -| ------------------------ | -------------------------------------------- | ------------ | -| `ENABLE_CAPTCHA` | Включить систему капчи | false | -| `CAPTCHA_ANSWER` | Правильный ответ на капчу | - | -| `CAPTCHA_CHECK_INTERVAL` | Интервал проверки обновления капчи (секунды) | 1800 | +| Переменная | Описание | По умолчанию | +| ----------------------- | ------------------------------------------------------------ | ------------ | +| `ENABLE_CAPTCHA` | Включить систему капчи | false | +| `CAPTCHA_ANSWER` | Правильный ответ на капчу | - | +| `CAPTCHA_CHECK_INTERVAL`| Интервал проверки обновления капчи (секунды) | 1800 | Капча добавляется в нижний спойлер первого поста темы: `Капча (обязательно)`. @@ -128,14 +130,37 @@ python main.py сколько будет 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. -| Переменная | Описание | По умолчанию | -| ---------------- | -------------------------------- | ------------ | -| `PROXY_TELEGRAM` | Использовать прокси для Telegram | false | -| `PROXY_LOLZ` | Использовать прокси для Lolz API | false | +| Переменная | Описание | По умолчанию | +| ----------------- | ----------------------------------------- | ------------ | +| `PROXY_TELEGRAM` | Использовать прокси для Telegram | false | +| `PROXY_LOLZ` | Использовать прокси для Lolz API | false | #### Вариант 1: Единая строка прокси @@ -151,13 +176,13 @@ PROXY=socks5://host:port #### Вариант 2: Отдельные параметры -| Переменная | Описание | По умолчанию | -| ---------------- | ---------------------------------- | ------------ | -| `PROXY_PROTOCOL` | Протокол прокси (socks5 или https) | socks5 | -| `PROXY_HOST` | Хост прокси-сервера | - | -| `PROXY_PORT` | Порт прокси-сервера | - | -| `PROXY_USERNAME` | Логин (опционально) | - | -| `PROXY_PASSWORD` | Пароль (опционально) | - | +| Переменная | Описание | По умолчанию | +| ----------------- | ---------------------------------------------- | ------------ | +| `PROXY_PROTOCOL` | Протокол прокси (socks5 или https) | socks5 | +| `PROXY_HOST` | Хост прокси-сервера | - | +| `PROXY_PORT` | Порт прокси-сервера | - | +| `PROXY_USERNAME` | Логин (опционально) | - | +| `PROXY_PASSWORD` | Пароль (опционально) | - | **Поддерживаемые форматы прокси:** @@ -179,17 +204,19 @@ PROXY=socks5://host:port **Формат:** -- Каждая строка — отдельный шаблон +- Каждая строка – отдельный шаблон - Можно использовать `||` для случайного выбора +- Поддерживается `\n` для многострочных комментариев **Пример:** ``` :catdance: Отправил звёзды || :animeyes2: Отправил :sadge: Тут может быть реклама +Первая строка\nВторая строка\nТретья строка ``` -Если файл пустой — используется `✓`. +Если файл пустой – используется `✓`. ## Поддержка