lingo push

Envía cambios en los archivos de origen, crea los archivos de destino faltantes o actualiza de forma intencional las traducciones seleccionadas.

Después de la configuración del primer archivo, usa lingo push --wait para los cambios habituales en el origen. La CLI compara los bytes del origen con su línea base, solicita el trabajo correspondiente a los cambios y descarga los destinos completados. Los orígenes idénticos byte por byte se omiten.

Los demás modos responden a tareas distintas. Elígelos según lo que necesites cambiar, en lugar de tratar cada ejecución de push como una traducción completa.

Elige el trabajo #

InvocaciónComportamiento
push normal sin una línea base válidaAlmacena los bytes del origen; no solicita una traducción inicial de forma automática.
push normal con una línea baseTraduce los cambios del origen de forma incremental.
lingo push 'locales/en.json'Planifica el trabajo con un alcance delimitado, sin la comparación habitual con el origen anterior; permite adoptar los destinos existentes.
lingo push --backfill-missingCrea los archivos de destino faltantes para los orígenes configurados.
push con alcance delimitado y --forceRegenera los destinos seleccionados en archivos separados sin conservar el contexto del destino existente.
push con --keySelecciona unidades con claves estables en los destinos existentes; la reutilización de valores sin cambios depende del formato.

La creación de archivos faltantes no agrega claves nuevas ni modificadas a un archivo de destino normal que ya existe. Advierte sobre los cambios del origen desde la línea base; completa esas actualizaciones habituales con un push normal antes de crear los archivos faltantes para mantener al día los idiomas existentes. Un documento que abarca menos idiomas de los configurados conserva la línea base existente del origen, de modo que un push normal posterior puede procesar las ediciones pendientes para los demás. Los catálogos XCStrings compartidos usan planificación por idioma. Los patrones posicionales solo seleccionan coincidencias dentro de la configuración, en lugar de admitir archivos arbitrarios.

Opciones #

OpciónEfecto
Patrones posicionalesSeleccionan archivos configurados; encierra entre comillas los comodines del intérprete de comandos.
--force, -fReemplazan las traducciones de archivos completos; usa patrones de archivo explícitos o la creación de archivos faltantes.
--backfill-missingInicializa los archivos de destino faltantes.
--key <pattern>Permite repetir la selección de unidades estables.
--yes, -yOmiten la confirmación del reemplazo forzado.
--wait, -wEsperan y descargan los resultados en lugar de finalizar después del envío.
--estimatePlanifica el trabajo y calcula su costo sin traducir ni crear una tarea.
--with <stage>Ejecuta una etapa solo para este envío; la opción se puede repetir.
--without <stage>Omite una etapa solo para este envío; la opción se puede repetir.
--review-*, --content-lengthAjusta la configuración de las etapas solo para este envío.

Las opciones booleanas tienen el valor false de forma predeterminada. Los destinos se toman de la configuración; push no tiene una opción de idioma. El reemplazo forzado de archivos completos solicita confirmación, a menos que la confirmación automática, el alcance por claves o la estimación la omitan. Sin patrones posicionales, --force selecciona todos los archivos de origen y los idiomas de destino configurados. Usa patrones de archivo explícitos y revisa el alcance con --estimate antes de hacer un reemplazo amplio. El reemplazo forzado puede sobrescribir las ediciones manuales del destino porque elimina el contexto del destino actual en los formatos de archivos separados. Los catálogos XCStrings y las tablas CSV aún pueden reutilizar las traducciones integradas en el archivo de origen compartido.

Actualiza las claves seleccionadas #

Usa una actualización por claves cuando hayan cambiado las indicaciones guardadas, pero no el texto de origen, o cuando necesites volver a traducir un subconjunto específico:

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

Las claves son rutas con puntos o corchetes. Seleccionar un objeto incluye todas las cadenas que contiene: auth.login incluye auth.login.title, pero no auth.login_url. * representa un segmento completo. La notación con barras de la CLI anterior, como auth/login, también funciona. JSON, JSONC, TypeScript y PHP regeneran las cadenas seleccionadas incluso cuando su origen no ha cambiado. YAML y YAML con claves raíz aceptan la selección de claves, pero pueden reutilizar los valores actuales del destino cuando su origen coincide con la línea base guardada. Para corregir la redacción en YAML, edita el destino directamente; para una regeneración más amplia después de cambiar las indicaciones, guarda los destinos aceptados y usa --force para archivos completos sin --key.

Los idiomas de destino faltantes y los formatos sin claves estables se omiten y se informa mediante mensajes; los demás formatos detienen push con un error. Inicializa los destinos faltantes por separado. Agregar --force a --key no cambia la planificación por claves ni impide la reutilización en YAML.

Un push con alcance por claves deja intacta la línea base del origen completo, tanto si push --wait recoge sus resultados como si lo hace un pull posterior. Así, las ediciones habituales pendientes del origen se procesan en el siguiente push normal. Alcances explica la matriz de formatos y la sintaxis de las claves.

Estima antes de hacer un reemplazo amplio #

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

La estimación planifica los cambios exactos sin traducir ni crear una tarea. Sube los archivos que le faltan al servidor para ese plan, por lo que es una llamada al servicio, no una simulación sin conexión. No reemplaza el puntero guardado de pull ni la línea base completada. El primer push solo almacena los orígenes, por lo que su estimación indica que no hay nada que estimar y remite a lingo push --estimate --backfill-missing.

La salida muestra el costo planificado, las traducciones que se producirán y reutilizarán, los tokens de salida y las filas por idioma. El costo condicional de las correcciones posteriores y el gasto facturado por tu propio proveedor de IA aparecen en líneas separadas y no se incluyen en el total planificado; a continuación, las advertencias indican qué queda fuera de la estimación. Los importes marcados con ~ son aproximados. Describen el plan, no el uso medido ni una cotización. Si un push es demasiado grande para estimarlo, falla e indica el motivo proporcionado por el servidor; especifica patrones de archivo para estimar solo una parte.

Cambiar las etapas para un solo envío #

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

Las opciones de etapa modifican la secuencia de procesamiento del motor solo para este envío, así que puedes probar una configuración sin editar ni volver a crear el motor. Los ajustes que no se especifiquen con una opción se toman del motor, incluidos sus grupos de revisión humana.

--with y --without aceptan pre-edit, rephrase, human-review, post-edit, content-length o back-translation. La traducción siempre se ejecuta. --without también omite las etapas que dependen de la etapa omitida: --without human-review omite la evaluación de IA y la posedición.

AjusteValores
--review-leveleverything envía todas las unidades a los revisores; strict, medium o lax envía solo las unidades que la evaluación de IA señala con ese nivel de gravedad.
--review-pool <name>Las revisiones usan este grupo en lugar de los grupos del motor.
--review-languages <locales>Idiomas que revisa el grupo --review-pool, separados por comas; de forma predeterminada, todos los idiomas.
--review-timeout <hours>La cantidad de horas disponibles para los revisores.
--content-length <rule>source, match:<percent> o max:<columns>.

Un ajuste modifica una etapa sin activarla, por lo que el envío falla si esa etapa no se ejecuta: agrega --with human-review o --with content-length. Usar --with human-review en un motor sin grupos de revisión requiere --review-pool. Si solicitas una etapa que tu plan no incluye, el envío falla en lugar de omitirla. El envío guarda sus resultados como cualquier otro envío; agrega --force o --key para volver a traducir las unidades sin cambios, y --estimate para calcular primero el costo de la configuración. Al reintentar, debes usar las mismas opciones de etapa.

Para agregar un idioma, primero completa las actualizaciones habituales del origen para los destinos existentes. Luego agrégalo a targetLocales, revisa lingo push --backfill-missing --estimate y solicita la creación de archivos faltantes sin cambiar la revisión del origen. Agregar un idioma describe esa secuencia hasta las comprobaciones en la aplicación. Quitar un idioma evita que se seleccione en el futuro, sin eliminar archivos. No uses la purga de idiomas en catálogos XCStrings compartidos.

Recoge y recupera los resultados #

Sin la opción de espera, conserva el checkout y el puntero local de la máquina hasta que pull recupere la salida. Otro push puede reemplazar ese puntero. Con la opción de espera, revisa los resultados fallidos o parcialmente fallidos y los archivos que realmente se descargaron. La espera termina cuando todos los destinos pendientes están a la espera de una revisión humana; ejecuta pull cuando los evaluadores terminen. No edites los destinos mientras se recogen los resultados directamente con la opción de espera, ya que este proceso no realiza la comparación actualizada de ediciones locales que hace pull.

Para reintentar el trabajo fallido, corrige la causa y sigue el procedimiento de recuperación de ejecuciones fallidas: repite el push adecuado conservando el estado, confirma el ID de tarea que se muestra y luego revisa la salida resultante. Si nunca se recogieron los resultados del push anterior y la solicitud no ha cambiado, push reutiliza esa solicitud en lugar de duplicarla: vuelve a vincularse a una tarea en curso, recoge los resultados de una tarea completada y reemplaza una tarea fallida por una nueva.