Translator Automation

Этот проект автоматизирует процесс перевода строк с использованием Google Gemini API и Playwright. Скрипт автоматически собирает непереведенные строки, отправляет их в Gemini для перевода и вставляет результат обратно в редактор.

Предварительные требования

Для запуска проекта на macOS вам понадобятся:

1. Go (Golang): Скачайте и установите последнюю версию с официального сайта или установите через Homebrew:

   brew install go

2. Git: Предустановлен на macOS, либо можно установить через Homebrew:

   brew install git

3. Google Gemini API Key: Получите ключ API в Google AI Studio.

Установка

1. Склонируйте репозиторий (или скачайте архив с кодом):

   git clone <ссылка-на-ваш-репозиторий>
   cd translator

2. Установите зависимости Go:

   go mod tidy

3. Установите браузеры для Playwright: Для избежания проблем совместимости версий необходимо устанавливать ту же версию, которая прописана в файле go.mod (на данный момент это v0.5200.1):

   go run github.com/playwright-community/playwright-go/cmd/playwright@v0.5200.1 install --with-deps

Настройка

1. Создайте файл конфигурации: Скопируйте файл .env-example и назовите его .env.

   cp .env-example .env

2. Отредактируйте .env: Откройте файл .env в любом текстовом редакторе (например, TextEdit, VS Code или nano) и заполните следующие поля:

   • GEMINI_API_KEY: Ваш ключ от Google Gemini.
   • MAX_CONCURRENCY: Количество параллельных окон (например, 3).
   • TRANSLATE_TO: Язык на который переводим (например, PL - польский, EN - англ).
   • Остальные параметры можно оставить по умолчанию.

3. Добавьте проекты: Откройте файл projects.txt и добавьте ссылки на проекты, которые нужно перевести. Каждая ссылка должна быть с новой строки. Пример:

   https://app.example.com/project/12345678.abc/translate/
   https://app.example.com/project/87654321.xyz/translate/
   

Сборка (Компиляция)

Если вы хотите собрать проект в один исполняемый файл для macOS, чтобы запускать его без вызова Go, выполните команду:

go build -o translator

После этого вы сможете запускать программу из терминала:

./translator

Или двойным кликом по файлу translator в Finder (в первый раз может потребоваться разрешить запуск в настройках безопасности macOS).

Запуск

1. Запустите программу (если не собирали бинарник):

   go run main.go

2. Первый запуск (Авторизация):

   • При первом запуске откроется окно браузера со страницей входа.
   • Введите логин и пароль вручную в браузере.
   • Если потребуется капча или 2FA, пройдите их.
   • После успешного входа вернитесь в консоль (терминал) и нажмите Enter.
   • Файл с куками сохранится в auth.json, и при следующих запусках вход будет выполнен автоматически.

Возможные проблемы

• Ошибка "playwright not found": Убедитесь, что вы выполнили шаг 3 из раздела "Установка".
• Ошибки перевода: Проверьте лимиты вашего API ключа Gemini.

Структура проекта

• main.go: Основной код программы.
• .env: Ваши секретные настройки (не передавайте этот файл никому).
• projects.txt: Список ссылок для обработки.
• auth.json: Файл сессии (создается автоматически).