# ⭐ 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. Клонируйте репозиторий:
   ```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            |
| `DEFAULT_CHOICE`      | 1 — реал-тайм, 2 — обработать все посты       | 2            |
| `ENABLE_REPLY`        | Отправлять ли комментарии                     | true         |
| `SKIP_COMMENTED`      | Пропускать посты, на которые уже отвечали     | true         |

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

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

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

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

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

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