Lolz/Auto-Pump-Compatible
4
0
Fork 0
forked from Lolz/Auto-Pump
Code Pull Requests Activity

Add files via upload

Browse Source
This commit is contained in:
imletbruh
2026-03-14 12:20:04 +05:00
committed by GitHub
parent 6ff5d695f4
commit fcaa53b5ce
7 changed files with 1351 additions and 378 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+154 -82
View File
@@ -1,21 +1,21 @@
# 🚀 QIYANA AUTO-BUMP BOT для Lolz.live
Бот для автоматического поднятия тем на форуме Lolz.live с удобным кнопочным интерфейсом
Production-ready Telegram бот для автоматического поднятия тем на форуме Lolz.live с современной архитектурой, batch API и полной типизацией.
## ✨ Возможности
- ➕ **Добавление тем** - через запятую (12345, 67890, 11111)
- 🗑️ **Удаление тем** - через кнопки с ID и названием темы
- ➕ **Добавление тем** - через запятую (12345, 67890, 11111) с batch API
- 🗑️ **Удаление тем** - через интерактивное меню
- 📋 **Список тем** - с датой последнего поднятия
- 🚀 **Ручное поднятие** - поднять все темы прямо сейчас
- 🚀 **Ручное поднятие** - поднять все темы немедленно через batch API
- ⏰ **Автоподнятие** - каждые N часов автоматически
- 📊 **Статистика** - успешность, количество поднятий
- 👤 **Кнопка автора** - ссылка на профиль
- 📊 **Статистика** - успешность, количество поднятий, uptime
- 🔔 **Уведомления** - о каждом поднятии темы
- 🛡️ **Обработка ошибок** - rate limits, network failures, invalid tokens
- ⚡ **Batch API** - до 10 тем за один запрос (10x быстрее)
## 🎮 Интерфейс
Бот работает через **кнопки**:
```
┌─────────────────────────────────┐
│ ➕ Добавить темы │ 📋 Список тем │
@@ -26,64 +26,67 @@
## 📦 Установка
### 1. Установите зависимости:
### Требования
- Python 3.12+
- pip или uv
### 1. Установите зависимости
```bash
pip install -r requirements.txt
```
### 2. Получите токены:
### 2. Получите токены
**Telegram Bot Token:**
1. Напишите [@BotFather](https://t.me/BotFather)
2. Создайте бота командой `/newbot`
2. Создайте бота: `/newbot`
3. Скопируйте токен
**Lolz API Token:**
1. Зайдите на [zelenka.guru/account/api](https://zelenka.guru/account/api)
1. Перейдите на [zelenka.guru/account/api](https://zelenka.guru/account/api)
2. Создайте токен с правами `read`, `post`
3. Скопируйте токен
### 3. Заполните `config.json`:
### 3. Настройте config.json
```json
{
"bot": {
"api_token": "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz"
"api_token": "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz",
"img_url": "https://wallpapers-clan.com/wp-content/uploads/2024/04/dark-anime-girl-with-red-eyes-desktop-wallpaper-preview.jpg",
"author_url": "https://lolz.live/kqlol/"
},
"api": {
"base_url": "https://api.zelenka.guru",
"auth_token": "eyJ0eXAiOiJKV1QiLCJhbGc..."
"base_url": "https://prod-api.lolz.live",
"auth_token": "eyJ0eXAiOiJKV1QiLCJhbGc...",
"batch_size": 10
},
"database": {
"path": "threads.db"
},
"scheduling": {
"bump_interval_hours": 12,
"bump_delay_seconds": 2,
"enable_auto_bump": true
}
}
```
### 4. Запустите бота:
### 4. Запустите бота
```bash
python app.py
```
## 📖 Использование
### Первый запуск:
1. Отправьте `/start` боту
2. Нажмите **➕ Добавить темы**
3. Введите ID тем через запятую: `12345, 67890, 11111`
4. Нажмите **🚀 Поднять темы** - все темы поднимутся
5. Бот будет автоматически поднимать темы каждые 12 часов
### Добавление тем:
### Добавление тем
1. Нажмите **➕ Добавить темы**
2. Введите ID через запятую: `12345, 67890`
3. Бот автоматически получит название каждой темы из API
4. Темы добавятся в базу данных
2. Введите ID через запятую: `12345, 67890, 11111`
3. Бот автоматически получит названия тем через batch API (до 10 за запрос)
**Пример:**
```
@@ -95,36 +98,46 @@ python app.py
✅ 9247922 - VPN service
```
### Удаление темы:
**Batch API преимущества:**
- Добавление 10 тем = 1 batch запрос вместо 10 обычных
- Добавление 25 тем = 3 batch запроса вместо 25 обычных
- Экономия API лимитов в 10 раз
### Удаление темы
1. Нажмите **🗑️ Удалить тему**
2. Выберите тему из списка (показывается ID - название)
3. Тема удалится из базы данных
2. Выберите тему из списка
3. Подтвердите удаление
### Ручное поднятие:
### Ручное поднятие
1. Нажмите **🚀 Поднять темы**
2. Бот поднимет все темы по очереди
3. Каждый результат придет отдельным сообщением:
2. Бот поднимет все темы через batch API (до 10 за запрос)
3. Получите уведомление о каждой теме:
```
[1/3] ✅ Тема 9247920 поднята успешно
[2/3] ✅ Тема 9247921 поднята успешно
[3/3] ✅ Тема 9247922 поднята успешно
```
### Список тем:
**Batch API преимущества:**
- Поднятие 10 тем = 1 batch запрос (0.1 * 10 = 1 batch)
- Поднятие 50 тем = 5 batch запросов вместо 50 обычных
- Скорость выполнения увеличена в ~10 раз
### Просмотр списка
Нажмите **📋 Список тем** - покажет:
- ID темы
- Название темы
- Дату последнего поднятия
### Статистика:
### Статистика
Нажмите **📊 Статистика** - покажет:
- Количество тем в списке
- Сколько готовы к поднятию
- Всего попыток поднятия
- Количество тем
- Готовые к поднятию
- Всего попыток
- Успешность (%)
- Настройки интервала
- Время работы бота
@@ -133,18 +146,32 @@ python app.py
### Интервал автоподнятия
В `config.json` можно изменить `bump_interval_hours`:
В `config.json` измените `bump_interval_hours`:
| Значение | Интервал |
|----------|----------|
| `12` | 12 часов |
| `6` | 6 часов |
| `24` | 24 часа |
### Тестовый запуск (5 минут):
### Размер batch запросов
В `config.json` измените `batch_size`:
| Значение | Описание |
|----------|----------|
| `10` | Максимум (рекомендуется) - 10 тем за запрос |
| `5` | Средний - 5 тем за запрос |
| `1` | Отключить batch - по 1 теме |
**Примечание:** Batch API Lolz.live поддерживает до 10 запросов в одном batch. Каждый запрос = 0.1 batch, итого 10 запросов = 1 полный batch.
### Тестовый режим (5 минут)
Для теста поставьте:
```json
"scheduling": {
"bump_interval_hours": 0.0833,
"bump_delay_seconds": 1,
"enable_auto_bump": true
}
```
@@ -152,7 +179,7 @@ python app.py
## 🔄 Как работает автоподнятие
1. Запускаете бота
2. **Вручную** поднимаете темы через кнопку 🚀 (первый раз)
2. Вручную поднимаете темы через 🚀 (первый раз)
3. Бот ждет указанный интервал (например, 12 часов)
4. Автоматически поднимает темы, у которых прошло 12+ часов
5. Повторяет каждые 12 часов
@@ -160,58 +187,103 @@ python app.py
**Пример:**
```
00:00 - Запуск бота
00:05 - Вы вручную нажали "Поднять темы" (все темы поднялись)
12:05 - Автоматическое поднятие готовых тем
24:05 - Автоматическое поднятие готовых тем
36:05 - Автоматическое поднятие готовых тем
...
00:05 - Вы вручную нажали "Поднять темы"
12:05 - Автоматическое поднятие
24:05 - Автоматическое поднятие
36:05 - Автоматическое поднятие
```
⚡ **Важно:** Первое поднятие делаете ВЫ вручную через кнопку, потом бот сам!
## 🏗️ Архитектура
### Модульная структура
```
app.py # Main bot logic with FSM
config_manager.py # Type-safe configuration
api_client.py # Lolz batch API client with retry logic
database.py # SQLite with connection pooling
```
### Ключевые улучшения
- **Batch API**: До 10 тем за один запрос (10x эффективнее)
- **Type Safety**: Полная типизация с Python 3.12+ (PEP 695)
- **SOLID Principles**: Каждый модуль имеет одну ответственность
- **Connection Pooling**: Эффективное управление соединениями
- **Error Handling**: Специфичные исключения для каждого случая
- **Async Context Managers**: Автоматическая очистка ресурсов
- **Immutable Config**: Frozen dataclasses для безопасности
- **Logging**: Структурированные логи с rotation
- **Graceful Shutdown**: Корректное завершение всех задач
### Batch API Implementation
**Как работает:**
```python
# Старый способ (10 запросов):
for thread_id in [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]:
POST /threads/{thread_id}/bump
# Новый способ (1 batch запрос):
POST /batch
[
{"uri": "/threads/1/bump", "method": "POST"},
{"uri": "/threads/2/bump", "method": "POST"},
...
{"uri": "/threads/10/bump", "method": "POST"}
]
```
**Преимущества:**
- Экономия API лимитов в 10 раз
- Скорость выполнения увеличена в ~10 раз
- Меньше нагрузка на сеть
- Атомарная обработка результатов
### Edge Cases
- Rate limiting от API (обработка в batch ответах)
- Network timeouts (retry для batch запросов)
- Invalid tokens (валидация перед batch)
- Partial batch failures (индивидуальная обработка каждого результата)
- Concurrent access (connection pooling)
- Database locks (async context managers)
- Memory leaks prevention (frozen dataclasses, proper cleanup)
## 📝 Логи
- **Консоль** - основные события
- **bot.log** - детальные логи с ошибками
- **bot.log** - детальные логи с traceback
## 🔧 Технические детали
- **Версия aiogram**: 3.4.1
- **Python**: 3.8+
- **База данных**: SQLite (threads.db)
- **API**: https://api.zelenka.guru
- **Задержка между поднятиями**: 2 секунды
- **Python**: 3.12+
- **aiogram**: 3.4.1
- **aiohttp**: 3.10.0+
- **aiosqlite**: 0.20.0+
- **База данных**: SQLite с индексами
- **API**: https://prod-api.lolz.live
- **Batch API**: До 10 запросов за 1 batch (каждый = 0.1 batch)
## 📡 API запрос для поднятия
## 🐛 Troubleshooting
Бот использует такой запрос для каждой темы:
### Ошибка: "bot.api_token not configured"
```bash
curl --request POST \
--url https://api.zelenka.guru/threads/{THREAD_ID}/bump \
--header 'accept: application/json' \
--header 'authorization: Bearer {YOUR_TOKEN}'
```
Заполните `config.json` реальными токенами.
Бот автоматически извлекает:
- `thread_id` - ID темы
- `thread_title` - название темы
### Ошибка: "Invalid API token"
Из ответа API:
```json
{
"thread": {
"thread_id": ID,
"thread_title": "TITLE"
}
}
```
## 🐛 Если возникли проблемы
Проверьте токен на [zelenka.guru/account/api](https://zelenka.guru/account/api).
1. Проверьте токены в `config.json`
2. Убедитесь, что токены валидные
3. Посмотрите `bot.log` для деталей
4. Перезапустите бота
### Ошибка: "Network error"
Проверьте интернет-соединение и доступность API.
### Темы не поднимаются автоматически
1. Проверьте `enable_auto_bump: true` в config.json
2. Сделайте первое поднятие вручную через 🚀
3. Проверьте логи в bot.log
## 👤 Автор
@@ -219,4 +291,4 @@ curl --request POST \
---
**Приятного использования! 🚀**
**Приятного использования! 🚀**