Подключите свой движок

Lingo.dev CLI подключает кодовую базу к движку локализации через конфигурацию проекта. Каждый lingo push проходит через движок — тональность бренда, глоссарий, правила и настройки модели применяются автоматически. Код менять не нужно, новые зависимости не потребуются.

Что изменится#

	До	После
Пайплайн перевода	Стандартный пайплайн Lingo.dev	Ваш движок локализации
Тональность бренда	Нет	Применяется для каждой целевой локали
Глоссарий	Нет	Подбирается семантически для каждого запроса
Правила	Нет	Добавляются для каждой целевой локали
Выбор модели	По умолчанию в Lingo.dev	Ваша конфигурация модели с резервными вариантами
Проверка качества	Нет	Настроенные AI-оценщики запускаются автоматически

Настройка#

Подключите свой движок

Выполните lingo link в корне проекта:

bash

lingo link

Выберите (или создайте) организацию и движок локализации. link записывает orgId и engineId в .lingo/config.json — закоммитьте этот файл, чтобы при каждом запуске использовался один и тот же движок. ID движка также можно найти в панели управления; он начинается с eng_ (например, eng_SxjMwMsfOIsvV1wh).

Пройдите аутентификацию

bash

lingo login

Команда откроет браузер для аутентификации и сохранит сессию. Для CI или неинтерактивного использования вместо этого передайте API-ключ:

bash

lingo login --api-key lk_...

…или задайте его как переменную окружения:

bash

export LINGO_API_KEY="lk_..."

Сгенерируйте API-ключ на странице API Keys в панели управления.

Выполните push

bash

lingo push

CLI отправляет исходные файлы в движок и записывает переводы обратно на диск — тональность бренда, глоссарий, правила и настройки модели применяются автоматически.

Справочник по конфигурации#

`.lingo/config.json`#

Поле	Описание
`orgId`	Организация, которой принадлежит движок. Задаётся через `lingo link`.
`engineId`	Движок, который выполняет перевод (`eng_...`). Задаётся через `lingo link`.

sourceLocale, targetLocales и files работают так же, как и в любом другом проекте — см. Конфигурация.

Переменные окружения#

Переменная	Обязательно	По умолчанию	Описание
`LINGO_API_KEY`	Для CI	-	Ваш API-ключ Lingo.dev (вместо `lingo login`)
`LINGO_API_URL`	Нет	`https://api.lingo.dev`	Пользовательский базовый URL API (для self-hosted или staging)

Чего ожидать#

Каждый перевод, который создаёт CLI, проходит через полный пайплайн вашего движка:

Тональность бренда задаёт тон и уровень формальности для каждой локали
Термины из глоссария обеспечивают точную терминологию благодаря семантическому сопоставлению
Правила применяют языковые правила для каждой локали
Конфигурации моделей выбирают подходящую LLM с автоматическими резервными вариантами
AI-оценщики автоматически оценивают качество после каждого запроса

Переводы отображаются в Reports с типом триггера api — наряду с запросами из API и интеграций.