Lingo.dev CLI подключает кодовую базу к движку локализации через конфигурацию проекта. Каждый lingo push проходит через движок — тональность бренда, глоссарий, правила и настройки модели применяются автоматически. Код менять не нужно, новые зависимости не потребуются.
Что изменится#
| До | После | |
|---|---|---|
| Пайплайн перевода | Стандартный пайплайн Lingo.dev | Ваш движок локализации |
| Тональность бренда | Нет | Применяется для каждой целевой локали |
| Глоссарий | Нет | Подбирается семантически для каждого запроса |
| Правила | Нет | Добавляются для каждой целевой локали |
| Выбор модели | По умолчанию в Lingo.dev | Ваша конфигурация модели с резервными вариантами |
| Проверка качества | Нет | Настроенные AI-оценщики запускаются автоматически |
Настройка#
Подключите свой движок
Выполните lingo link в корне проекта:
lingo linkВыберите (или создайте) организацию и движок локализации. link записывает orgId и engineId в .lingo/config.json — закоммитьте этот файл, чтобы при каждом запуске использовался один и тот же движок. ID движка также можно найти в панели управления; он начинается с eng_ (например, eng_SxjMwMsfOIsvV1wh).
Пройдите аутентификацию
lingo loginКоманда откроет браузер для аутентификации и сохранит сессию. Для CI или неинтерактивного использования вместо этого передайте API-ключ:
lingo login --api-key lk_...…или задайте его как переменную окружения:
export LINGO_API_KEY="lk_..."Сгенерируйте API-ключ на странице API Keys в панели управления.
Выполните push
lingo pushCLI отправляет исходные файлы в движок и записывает переводы обратно на диск — тональность бренда, глоссарий, правила и настройки модели применяются автоматически.
Справочник по конфигурации#
.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 и интеграций.
