lingo push

Отправляйте изменения исходников, создавайте недостающие целевые файлы или обновляйте выбранные переводы.

После настройки первого файла используйте lingo push --wait для обычных правок исходников. CLI побайтово сравнивает исходники с базовой версией, запрашивает перевод изменений и скачивает готовые целевые файлы. Исходники, совпадающие до байта, пропускаются.

У других режимов свои задачи. Выбирайте режим по тому, что нужно изменить: не каждый push запускает полный перевод.

Выберите задачу #

ВызовЧто делает
Обычный push без действительной базовой версииСохраняет байты исходников, но не запрашивает первоначальный перевод автоматически.
Обычный push с базовой версиейПереводит только изменения в исходниках.
lingo push 'locales/en.json'Планирует работу в заданных пределах без обычного сравнения с предыдущим исходником. Может принять существующие целевые файлы как есть.
lingo push --backfill-missingСоздаёт недостающие целевые файлы для исходников, указанных в конфигурации.
Push в заданных пределах с --forceЗаново создаёт выбранные переводы в отдельных целевых файлах, не сохраняя контекст существующего перевода.
Push с --keyВыбирает единицы со стабильными ключами в существующих целевых файлах. Повторное использование неизменённых значений зависит от формата.

Дозаполнение не добавляет новые или изменённые ключи в уже существующий обычный целевой файл. Оно предупреждает об изменениях исходников относительно базовой версии. Чтобы переводы на существующие языки оставались актуальными, перед дозаполнением завершите эти обновления обычным push. Если документ охватывает не все настроенные локали, существующая базовая версия исходника сохраняется. Поэтому следующий обычный push сможет обработать ещё не отправленные правки для остальных локалей. Общие каталоги XCStrings используют планирование по локалям. Позиционные шаблоны выбирают только файлы из конфигурации, а не произвольные файлы.

Параметры #

ПараметрЧто делает
Позиционные шаблоныВыбирают файлы из конфигурации. Заключайте шаблоны с подстановочными знаками оболочки в кавычки.
--force, -fЗаменяют переводы файлов целиком. Используйте явно заданные шаблоны файлов или дозаполнение.
--backfill-missingСоздаёт недостающие целевые файлы.
--key <pattern>Выбирает единицы со стабильными ключами. Параметр можно указать несколько раз.
--yes, -yПропускают подтверждение принудительной замены.
--wait, -wОжидают завершения и скачивают результат вместо выхода сразу после отправки.
--estimateПланирует работу и рассчитывает стоимость без перевода и создания задания.
--with <stage>Запускает этап только для этого push. Флаг можно указать несколько раз.
--without <stage>Пропускает этап только для этого push. Флаг можно указать несколько раз.
--review-*, --content-lengthМеняет настройки этапа только для этого push.

По умолчанию логические флаги имеют значение false. Целевые локали берутся из конфигурации: у push нет флага локали. При принудительной замене файла целиком запрашивается подтверждение, кроме случаев, когда используется yes, задана область видимости ключей или запущена оценка стоимости. Без позиционных шаблонов --force выбирает все исходные файлы и целевые локали из конфигурации. Перед масштабной заменой явно задайте шаблоны файлов и проверьте охват с помощью --estimate. Принудительная замена может перезаписать ручные правки перевода, потому что для форматов с отдельными файлами она очищает контекст текущего целевого файла. Каталоги XCStrings и таблицы CSV при этом могут повторно использовать переводы, встроенные в общий исходный файл.

Обновите выбранные ключи #

Обновляйте отдельные ключи, если сохранённые указания изменились, а исходный текст — нет, или если повторный перевод нужен для определённого набора строк:

sh
lingo push 'locales/en.json' --key 'checkout.title' --key 'checkout.submit' --wait

Ключи — это пути с точками и скобками. Выбор объекта включает все вложенные строки: auth.login включает auth.login.title, но не auth.login_url. * обозначает один целый сегмент. Запись с косыми чертами из прежней версии CLI, например auth/login, тоже работает. JSON, JSONC, TypeScript и PHP заново создают выбранные строки, даже если исходник не изменился. YAML и YAML с корневыми ключами поддерживают выбор ключей, но могут повторно использовать текущие значения перевода, если исходник совпадает с сохранённой базовой версией. Чтобы исправить формулировку в YAML, отредактируйте целевой файл напрямую. Для более широкого обновления после изменения указаний сохраните принятые переводы и используйте --force для всего файла без --key.

Недостающие целевые локали и форматы без стабильных ключей пропускаются с сообщениями об этом. Другие форматы останавливают push с ошибкой. Создавайте недостающие целевые файлы отдельно. Добавление --force к --key не меняет планирование по выбранным ключам и не предотвращает повторное использование значений YAML.

Push по выбранным ключам не меняет базовую версию всего исходника независимо от того, получает результаты push --wait или последующий pull. Поэтому ещё не отправленные обычные правки исходника попадут в следующий обычный push. В разделе Области видимости описаны поддержка форматов и синтаксис ключей.

Оцените стоимость перед масштабной заменой #

sh
lingo push 'locales/en.json' --force --estimate

Оценка стоимости планирует точный объём изменений без перевода и создания задания. При этом она загружает файлы, которых серверу не хватает для плана: это обращение к сервису, а не пробный запуск без сети. Сохранённый указатель для pull и базовая версия завершённой работы не меняются. Первый push только сохраняет исходники, поэтому его оценка сообщает, что оценивать нечего, и указывает на lingo push --estimate --backfill-missing.

Вывод показывает плановую стоимость, переводы для создания и повторного использования, выходные токены и строки по каждой локали. Возможная стоимость последующих исправлений и расходы, которые выставляет ваш AI-провайдер, показаны отдельными строками и не входят в плановый итог. Затем предупреждения уточняют, что не учтено в оценке. Суммы с пометкой ~ приблизительны. Они описывают план, а не фактическое использование или ценовое предложение. Если push слишком велик для оценки, команда завершается с ошибкой и показывает причину, полученную от сервера. Передайте шаблоны файлов, чтобы оценить часть работы.

Изменение этапов для одного push #

bash
lingo push 'locales/en.json' --force --wait --with human-review --review-level strict --review-timeout 12 --without pre-edit

Флаги этапов меняют пайплайн движка только для этого push. Так вы можете попробовать конфигурацию, не меняя движок и не создавая его заново. Все настройки, не заданные флагами, берутся из движка, в том числе пулы ручной проверки.

--with и --without принимают значения pre-edit, rephrase, human-review, post-edit, content-length или back-translation. Перевод выполняется всегда. --without также пропускает этапы, которые зависят от пропущенного: --without human-review пропускает AI-оценку и постредактирование.

НастройкаЗначения
--review-leveleverything отправляет на ручную проверку каждую единицу. strict, medium или lax — только единицы, в которых AI-оценка выявила проблемы указанного уровня серьёзности.
--review-pool <name>Для проверки используется этот пул вместо пулов движка.
--review-languages <locales>Локали, которые проверяет пул --review-pool, через запятую. По умолчанию — все локали.
--review-timeout <hours>Срок ручной проверки в часах.
--content-length <rule>source, match:<percent> или max:<columns>.

Настройка меняет параметры этапа, но не включает его. Если этап не запускается, push завершится с ошибкой. Чтобы включить этап, добавьте --with human-review или --with content-length. Для --with human-review в движке без пулов проверки нужно указать --review-pool. Если запрошенный этап недоступен на вашем плане, push завершится с ошибкой, а не пропустит этап. Результаты записываются как при любом другом push. Добавьте --force или --key, чтобы повторно перевести неизменённые единицы, и --estimate, чтобы сначала рассчитать стоимость конфигурации. При повторной попытке нужно указать те же флаги этапов.

Перед добавлением нового языка завершите обычные обновления исходников для существующих целевых файлов. Затем добавьте язык в targetLocales, проверьте lingo push --backfill-missing --estimate и запросите дозаполнение, не меняя ревизию исходника. В разделе Добавление языка описана вся последовательность, включая проверки в приложении. Удаление локали исключает её из дальнейшего выбора, но не удаляет файлы. Не используйте очистку локали для общих каталогов XCStrings.

Получите результаты и восстановите работу #

Без ожидания сохраняйте checkout и локальный указатель на этом компьютере, пока pull не получит результаты. Другой push может заменить этот указатель. При работе с ожиданием проверяйте результаты полностью или частично неудавшихся заданий и фактически скачанные файлы. Ожидание прекращается, когда все незавершённые целевые переводы ожидают ручной проверки. Запустите pull, когда проверяющие закончат работу. Не редактируйте целевые файлы во время прямого получения результатов с ожиданием: в отличие от pull, оно не сравнивает их с актуальными локальными правками.

Чтобы повторить неудавшуюся работу, устраните причину сбоя и следуйте инструкциям по восстановлению после неудачного запуска: повторите нужный push, сохранив состояние, подтвердите выведенный ИД задания, затем проверьте результаты. Если результаты предыдущего push ещё не получены и запрос не изменился, push использует тот же запрос, не создавая дубликат: заново подключается к выполняющемуся заданию, получает результаты завершённого или заменяет неудавшееся задание новым.