### 📝 Описание программ

#### 1. «Быстрый переводчик» (Modern Translator)
Современное настольное приложение для молниеносного перевода текста. Отлично подходит для ручной работы, тестирования переводов или общения. Построено на базе библиотеки `CustomTkinter`, благодаря чему имеет стильный дизайн, скругленные элементы и автоматически подстраивается под темную или светлую тему вашей операционной системы.

**Главные функции:**
* **Интеллектуальное автоопределение языка:** Программа сама понимает, на каком языке написан исходный текст.
* **Обход лимитов Google:** Если вставить огромный текст, программа незаметно для пользователя разобьет его на части (по 4800 символов), переведет каждую с безопасным таймаутом и склеит обратно. Никаких блокировок от Google!
* **Управление с клавиатуры:** Нажатие `Enter` мгновенно запускает перевод, а `Shift + Enter` делает перенос строки. 
* **Удобные инструменты:** Кнопка «Скопировать» для быстрого переноса результата в буфер обмена, кнопка «Очистить» для мгновенного сброса окон и «Сохранить» для экспорта перевода в `.txt` файл.
* **Асинхронность:** Интерфейс не зависает во время ожидания ответа от серверов.

#### 2. «Групповой локализатор кода» (PRO Translator)
Мощный инструмент для массового автоматического перевода проектов (исходного кода). Программа сама сканирует папки, находит файлы исходного кода (Python, QML, JS и др.) и переводит только читаемый текст, не ломая архитектуру программы.

**Главные функции:**
* **Умный парсинг кода:** Использует лексический анализ (`tokenize` для Python) и регулярные выражения, чтобы извлекать текст *только* из кавычек и комментариев, полностью игнорируя системный код (циклы, переменные, функции).
* **Умный фильтр технических строк:** Защищает от перевода системные ключи, пути к файлам (`assets/logo.png`) и переменные (`camelCase`, `snake_case`). Переводятся только осмысленные фразы или иероглифы.
* **Восстановление плейсхолдеров:** Автоматически чинит переменные форматирования (например, возвращает `% s` обратно в `%s`), которые часто портит Google Переводчик.
* **Безопасность (Бэкапы):** Автоматически создает резервные копии оригинальных файлов с расширением `.bak` перед любыми изменениями.
* **Фильтр исходного языка:** Позволяет указать, что переводить нужно *только* с китайского или японского, пропуская английский текст.
* **Детальная статистика:** Визуальный прогресс-бар и журнал логов (Log) в реальном времени показывают, какой файл сейчас обрабатывается и сколько всего переведено.

---

### ⚙️ Инструкция по компиляции в `.exe`

Для превращения `.py` скриптов в `.exe` мы будем использовать самую популярную библиотеку — **PyInstaller**.

#### Шаг 1: Подготовка
Откройте терминал (командную строку `cmd` или PowerShell) и установите PyInstaller:
```bash
pip install pyinstaller
```

#### Шаг 2: Компиляция «Группового переводчика» (PRO Translator)
Перейдите в папку, где лежит ваш скрипт (например, `pro_translator.py`). Выполните следующую команду:

```bash
pyinstaller --noconsole --onefile pro_translator.py
```
* **`--noconsole`** (или `-w`) — скрывает черное окно командной строки, чтобы открывался только красивый графический интерфейс.
* **`--onefile`** (или `-F`) — упаковывает все библиотеки, зависимости и сам Python в один единственный `.exe` файл (его будет удобно переносить).

#### Шаг 3: Компиляция «Быстрого переводчика» (Modern Translator)
Так как этот скрипт использует нестандартную библиотеку отрисовки интерфейса (`customtkinter`), PyInstaller'у нужно явно указать, чтобы он захватил её графические ассеты. Выполните команду:

```bash
pyinstaller --noconsole --onefile --collect-all customtkinter modern_translator.py
```
* **`--collect-all customtkinter`** — гарантирует, что шрифты и темы CustomTkinter будут корректно встроены в `.exe`.

#### Шаг 4: Где найти готовые программы?
После того как консоль закончит работу (это может занять 1–3 минуты), в вашей папке со скриптами появятся новые папки: `build` и `dist`.
1. Зайдите в папку **`dist`**.
2. Именно там лежат ваши готовые `modern_translator.exe` и `pro_translator.exe`.
3. Теперь эти файлы можно копировать, переносить на флешке и запускать на других компьютерах с Windows. Папки `build` и файлы `.spec` можно удалить, они нужны были только для сборки.

> 💡 **Важное замечание про Антивирусы:** 
> Windows Defender или другие антивирусы иногда могут ругаться на `.exe` файлы, созданные через `PyInstaller` (выдавать предупреждение "Неизвестный издатель"). Это абсолютно нормальная реакция системы на программы без платной цифровой подписи разработчика. Просто нажмите "Подробнее" -> "Выполнить в любом случае" или добавьте файл в исключения.