Мульти-комбайн для ТГ [ Нет ограничений по аккаунтам | Tdata → Session | Управление Профилями | Парсеры | Session → API | Гибкие Настройки | Запуск по группам | Запуск | Автоответчик | AI Ассистент | Логи]

## Описание всех вкладок

---

### 👤 Аккаунты

Главная вкладка управления аккаунтами Telegram.

#### Как добавить аккаунт

**Через API (номер телефона + код):**
1. Нажми кнопку **+ API**
2. Введи номер телефона в формате `+79001234567`
3. Введи **API ID** и **API Hash** — получить на [my.telegram.org](https://my.telegram.org)
4. При необходимости укажи прокси
5. Нажми **ПОДКЛЮЧИТЬ** — на телефон придёт код, введи его в появившемся диалоге
6. Если включена 2FA — введи пароль

**Через .session файл:**
1. Нажми кнопку **+ Сессия**
2. Выбери один или несколько `.session` файлов
3. Аккаунты добавятся автоматически

**Через Tdata (папка Telegram Desktop):**
1. Нажми кнопку **Tdata**
2. Введи **API ID** и **API Hash** в появившемся диалоге (обязательно — без них аккаунт не подключится)
3. Выбери папку `tdata` из Telegram Desktop — программа автоматически найдёт файл `key_data` внутри
4. Аккаунт будет добавлен и готов к работе

#### Таблица аккаунтов

В таблице отображается:
- **ID** — внутренний номер аккаунта
- **Имя** — имя из профиля или номер телефона
- **Телефон** — номер телефона
- **Статус** — ✅ ok / ❌ error / 🆕 новый / ❓ неизвестно
- **Спам** — статус спам-блокировки (OK / SPAM)
- **Непрочит.** — количество непрочитанных сообщений
- **Прокси** — настроенный прокси

#### Управление аккаунтами

- **Двойной клик** по аккаунту → диалог настройки прокси
- **Выбрать все** — выделить все аккаунты
- **Удалить** — удалить выбранные аккаунты из базы
- **Проверить спам** — отправить запрос к @SpamBot и обновить статус
- **Проверить авторизацию** — проверить что сессии активны

#### Прокси

Поддерживаемые типы:
- **SOCKS5** — рекомендуемый формат
- **SOCKS4**
- **HTTP**
- **MTProto** — встроенный прокси Telegram

Формат: `хост:порт` с опциональными логином и паролем. Каждый аккаунт использует свой прокси при всех операциях (рассылка, проверка, парсинг).

---

### 🔄 Tdata → Session

Конвертер папок `tdata` от Telegram Desktop в `.session` файлы для Telethon.

#### Как использовать

1. Нажми **Выбрать папку** — укажи корневую папку где хранятся несколько `tdata`-папок
2. Программа автоматически найдёт все `tdata` внутри (до 4 уровней вложенности)
3. Отображается список найденных папок
4. Введи **API ID** и **API Hash** (нужны для всех конвертируемых аккаунтов)
5. Нажми **▶ СТАРТ**

#### Результат

Готовые `.session` файлы сохраняются в папку `NewSessions/` рядом с программой. Их можно загрузить через вкладку **Аккаунты → + Сессия**.

---

### ✏ Профили

Массовое редактирование профилей аккаунтов: аватарки, имена, описание (БИО), username.

#### Аватарки

- Включи переключатель **Изменять аватарки**
- Нажми **Выбрать папку** с изображениями (PNG, JPG, WEBP, BMP)
- Каждому аккаунту будет назначена случайная аватарка из папки

#### Имена

- Включи переключатель **Изменять имена**
- Введи варианты в формате `Имя Фамилия` (каждый с новой строки), или загрузи TXT файл
- Каждому аккаунту присваивается случайное имя из списка

#### БИО (описание)

- Включи переключатель **Изменять БИО**
- Введи варианты описания (каждый с новой строки), или загрузи TXT файл

#### Username

- Включи переключатель **Изменять username**
- Введи варианты (каждый с новой строки, `@` не обязателен)
- Учти что username должен быть уникальным — если занят, операция пропускается

#### Управление

Кнопки **СТАРТ / ПАУЗА / ПРОДОЛЖИТЬ / ОСТАНОВИТЬ** работают стандартно. Прогресс отображается в логах внизу экрана.

---

### 🔍 Парсер

Сбор пользователей из Telegram-групп и каналов для последующей рассылки.

#### Источник групп

Вставь ссылки или @username групп в текстовое поле (каждая с новой строки). Например:
```
@durov
https://t.me/telegram
cryptogroup
```

#### Режимы парсинга

- **По участникам** — собирает список всех участников группы
- **По чату (писавшие в чате)** — только те кто писал сообщения
- **По системным сообщениям (входы)** — пользователи по событиям вступления

#### Временной промежуток

Применяется к режимам "По чату" и "По системным сообщениям":
- **Дни** — сообщения/входы за последние N дней
- **Сообщения** — последние N сообщений
- **Без ограничений** — весь доступный архив

#### Фильтр активности

Фильтрует пользователей по дате последнего захода в Telegram:
- Любая / За день / За 3 дня / За 7 дней / За 14 дней / За 30 дней

#### Фильтры

- **Только с юзернеймом** — пропустить аккаунты без @username
- **Только Premium** — только подписчики Telegram Premium
- **Только с аватаром** — только с фото профиля
- **Пропускать кириллицу в именах** — исключить Славянские имена
- **Исключать ботов** — пропустить аккаунты-боты
- **Удалять дубли (глобально)** — один пользователь попадёт в список только один раз
- **Сохранять с @** — добавлять `@` перед username при сохранении
- **Запрещённые слова в именах** — исключить пользователей с определёнными словами в имени

#### Результаты

Файлы сохраняются в папку `parsed/` рядом с программой. Нажми **Открыть папку** для быстрого доступа.

---

### 🔑 Session → API

Извлечение API ID и API Hash из существующих `.session` файлов.

#### Как использовать

1. Нажми **Выбрать папку** — укажи папку с `.session` файлами
2. Программа автоматически найдёт все файлы (рекурсивно)
3. Нажми **▶ СТАРТ**
4. Полученные данные сохраняются в папку `api_data/` в файлы `api_credentials.txt` и `api_credentials.json`

Полезно когда есть сессии но утеряны API-ключи — они вшиты в сессию при авторизации.

---

### ⚙ Настройки

Глобальные параметры рассылки, применяемые во вкладке **Запуск**.

#### Потоки и задержки

- **Количество потоков** — сколько аккаунтов работают одновременно (слайдер 1–50)
- **Задержка между сообщениями** — от/до секунд (случайное значение в диапазоне)

#### Количество сообщений

- **Фиксированное** — каждый аккаунт отправляет ровно N сообщений
- **Случайное** — случайное число от Min до Max

#### Дополнительные опции

- **Игнорировать ошибки** — продолжать рассылку даже при ошибках (флуд, блок и т.д.)
- **Имитация печатания** — перед отправкой показывает статус "печатает..." на случайное время
- **Только приветственный смайлик** — вместо текста отправляет 👋

---

### 📢 Запуск по группам

Рассылка сообщений в Telegram-группы и каналы.

#### Потоки

Указывает сколько аккаунтов работают **одновременно**. Например, значение `3` означает что 3 аккаунта будут параллельно делать рассылку по своим группам.

#### Режим работы

**Зацикленный** — аккаунты бесконечно делают круги по группам пока не нажмёшь СТОП. Идеален для постоянного присутствия в группах.

**Фиксированное количество кругов** — при выборе этого режима появляется поле ввода. Каждый аккаунт пройдёт по всем группам ровно N раз и остановится.

#### Задержки

**Между сообщениями** — пауза после каждой отправки внутри одного круга. Указывается диапазон "от / до" в секундах — задержка будет случайной в этом диапазоне.

**Между повторными кругами** — сколько ждать перед следующим кругом. Тоже задаётся диапазоном.

Пример: задержка между сообщениями 10–30 сек, между кругами 300–600 сек — аккаунт напишет во все группы с паузами 10–30 сек, потом подождёт 5–10 минут и начнёт заново.

#### Источник групп

**Новые группы** — аккаунт сначала **вступает** в группу, потом отправляет сообщение. Группы вводятся вручную в текстовое поле (каждая с новой строки) или загружаются из TXT файла. Форматы: `@username`, `https://t.me/groupname`, просто `groupname`.

**Мои группы** — рассылка только в те группы, в которых аккаунт **уже состоит**. Список подгружается автоматически с каждого аккаунта при запуске. Вводить ничего не нужно.

#### Сообщения

**Одно сообщение для всех** — одно текстовое поле, все аккаунты и группы получают одинаковое сообщение.

**Случайное из списка** — несколько сообщений разделяются строкой `---`. При каждой отправке выбирается случайное. Пример:
```
Привет! У нас акция 50% на всё!
---
Добрый день! Специальное предложение только сегодня
---
Здравствуйте! Не пропустите нашу распродажу
```

#### Управление

- **▶ СТАРТ** — запуск рассылки
- **⏸ ПАУЗА** — временная остановка (можно возобновить)
- **▶ ПРОДОЛЖИТЬ** — возобновить после паузы
- **⛔ ОСТАНОВИТЬ** — полная остановка
- **💾 СОХРАНИТЬ** — сохранить все настройки в базу данных (восстановятся после перезапуска)

---

### 🚀 Запуск

Рассылка личных сообщений пользователям из базы (результаты парсера).

#### Сообщения для аккаунтов

Режимы выбора сообщения:
- **Случайное** — при каждой отправке берётся случайное из списка
- **По порядку** — сообщения чередуются по очереди

Сообщения вводятся в текстовое поле и разделяются строкой `---`.

Кнопки под текстовым полем:
- **📄 Загрузить TXT** — загрузить сообщения из файла
- **💾 Сохранить** — сохранить сообщения

#### Список получателей

Вставь @username или номера телефонов получателей (каждый с новой строки), или загрузи из TXT файла — результаты парсера.

- **Уже отправлено** — счётчик из базы ранее отправленных
- **Очистить базу** — сбросить историю отправок (пользователи снова попадут в список)

#### Управление

Те же кнопки: СТАРТ / ПАУЗА / ПРОДОЛЖИТЬ / ОСТАНОВИТЬ.

Настройки потоков, задержек и количества сообщений берутся из вкладки **Настройки**.

---

### 📨 Автоответчик

Автоматически отвечает на входящие сообщения в личке.

#### Принцип работы

Аккаунты прослушивают входящие сообщения. Когда приходит новое сообщение от пользователя, которому ещё не отвечали — отправляется заданный текст. Каждому пользователю сообщение отправляется **только один раз** (ведётся база).

#### Настройка

1. Нажми **✔ ВКЛЮЧИТЬ** — активирует режим автоответа
2. Введи текст ответного сообщения
3. Нажми **💾 СОХРАНИТЬ**
4. Нажми **▶ СТАРТ**

#### База автоответчика

- Показывает сколько пользователей уже получили ответ
- **Очистить базу** — пользователи снова будут получать ответ при следующем сообщении

---

### 🤖 AI Ассистент

Умный автоответчик на базе искусственного интеллекта. Отвечает на входящие сообщения осмысленными ответами через нейросеть.

#### Поддерживаемые AI-провайдеры

- **Gemini (Google)** — получить ключ на [aistudio.google.com](https://aistudio.google.com)
- **Groq** — получить ключ на [console.groq.com](https://console.groq.com)
- **OpenRouter** — получить ключ на [openrouter.ai](https://openrouter.ai) (есть бесплатные модели)

#### Ротация ключей

В поле ввода можно вставить несколько ключей через запятую. При исчерпании лимита одного ключа автоматически переключается на следующий.

#### Настройка промпта

В поле **Системный промпт** опиши роль ассистента. Например:
```
Ты менеджер по продажам компании X. Отвечай кратко и по делу.
Цель — записать клиента на консультацию.
```

#### Контекстные файлы

Можно добавить TXT или JSON файлы с информацией о продукте/компании. AI будет использовать их при ответах на соответствующие вопросы.

#### Скриншоты

Можно добавить изображения (PNG/JPG). При определённых ключевых словах в сообщении клиента (например "докажи", "скриншот", "покажи результат") AI автоматически отправит скриншот.

---

### 📋 Логи

Полная история всех операций программы. Автоматически обновляется в реальном времени.

Уровни логов:
- ◆ **INFO** — обычные события
- ▲ **WARN** — предупреждения
- ✖ **ERROR** — ошибки
- ✔ **SUCCESS** — успешные операции

Кнопка **Очистить** — очищает отображение (из файла `data/app.log` логи не удаляются).

---