lingo push

Envía los cambios del origen, crea los archivos de destino que faltan o actualiza expresamente las traducciones seleccionadas.

Tras la configuración del primer archivo, usa lingo push --wait para las modificaciones habituales del origen. La CLI compara los bytes del origen con su referencia, solicita el trabajo correspondiente a los cambios y descarga los destinos completados. Los orígenes idénticos byte a byte se omiten.

Cada uno de los demás modos responde a una tarea distinta. Elígelos según lo que quieras cambiar, en lugar de tratar cada push como una traducción completa.

Elige el trabajo que quieres realizar #

InvocaciónComportamiento
Push normal sin una referencia válidaGuarda los bytes del origen; no solicita automáticamente una traducción inicial.
Push normal con una referenciaTraduce los cambios del origen de forma incremental.
lingo push 'locales/en.json'Planifica el trabajo por ámbito sin la comparación habitual con el origen anterior; permite adoptar los destinos existentes.
lingo push --backfill-missingCrea los archivos de destino que faltan para los orígenes configurados.
Push de ámbito limitado con --forceRegenera los destinos seleccionados en archivos independientes 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.

El relleno de destinos no añade claves nuevas o modificadas a un archivo de destino normal que ya existe. Advierte de los cambios en el origen desde la referencia; completa esas actualizaciones habituales con un push normal antes del relleno para mantener al día los idiomas existentes. Un documento que abarca menos idiomas de los configurados conserva la referencia existente del origen, por lo que un push normal posterior puede seguir procesando las modificaciones pendientes para los demás idiomas. Los catálogos XCStrings compartidos usan planificación por idioma. Los patrones posicionales se limitan a los archivos que coinciden con la configuración, en lugar de admitir archivos arbitrarios.

Opciones #

OpciónEfecto
Patrones posicionalesSeleccionan archivos configurados; escribe los comodines del intérprete de comandos entre comillas.
--force, -fSustituyen las traducciones de archivos completos; usa patrones de archivo explícitos o el relleno de destinos.
--backfill-missingInicializa los archivos de destino que faltan.
--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 terminar tras el envío.
--estimatePlanifica el trabajo y calcula su coste sin traducir ni crear una tarea.
--with <stage>Ejecuta una etapa solo para este envío; se puede repetir.
--without <stage>Omite una etapa solo para este envío; se puede repetir.
--review-*, --content-lengthAjusta la configuración de una etapa solo para este envío.

Las opciones booleanas están desactivadas 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, salvo que la confirmación automática, la selección por claves o la estimación la supriman. Sin patrones posicionales, --force selecciona todos los archivos de origen e idiomas de destino configurados. Usa patrones de archivo explícitos y comprueba el ámbito con --estimate antes de realizar un reemplazo amplio. El reemplazo forzado puede sobrescribir las modificaciones manuales del destino porque borra el contexto del destino actual en los formatos con archivos independientes. Los catálogos XCStrings y las tablas CSV pueden seguir reutilizando las traducciones integradas en el archivo de origen compartido.

Actualiza las claves seleccionadas #

Usa una actualización por claves cuando hayan cambiado las directrices guardadas, pero no el texto de origen, o cuando un subconjunto concreto necesite volver a traducirse:

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

Las claves son rutas con puntos o corchetes, y seleccionar un objeto incluye todas las cadenas que contiene: auth.login incluye auth.login.title, pero no auth.login_url. * representa un segmento completo. También funciona el formato con barras de la CLI anterior, como auth/login. JSON, JSONC, TypeScript y PHP regeneran las cadenas seleccionadas aunque su origen no haya cambiado. YAML y YAML con claves raíz admiten la selección por claves, pero pueden reutilizar los valores actuales del destino cuando su origen coincide con la referencia guardada. Para corregir la redacción en YAML, edita el destino directamente; para una regeneración más amplia tras cambiar las directrices, guarda los destinos aceptados y usa --force para el archivo completo sin --key.

Los idiomas de destino que faltan y los formatos sin claves estables se omiten y se muestran los mensajes correspondientes; otros formatos detienen el push con un error. Inicializa los destinos que faltan por separado. Añadir --force a --key no cambia la planificación por claves ni impide la reutilización en YAML.

Un push limitado a claves deja intacta la referencia del origen completo, tanto si sus resultados se recogen con push --wait como con un pull posterior. Así, las modificaciones habituales pendientes del origen siguen procesándose en el siguiente push normal. Ámbitos explica la matriz de formatos y la sintaxis de las claves.

Calcula una estimación antes de 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 sustituye el puntero de pull guardado ni la referencia completada. El primer push solo guarda 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 coste previsto, las traducciones que se van a generar y reutilizar, los tokens de salida y las filas por idioma. El coste de las posibles correcciones posteriores y el gasto facturado por tu propio proveedor de IA aparecen en líneas independientes y se excluyen del total previsto; 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 un presupuesto. 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 único envío #

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

Los parámetros de etapa modifican el flujo 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 indiquen mediante un parámetro 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; por defecto, todos los idiomas.
--review-timeout <hours>El número de horas de que disponen 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: añade --with human-review o --with content-length. Para usar --with human-review en un motor sin grupos de revisión, necesitas --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; añade --force o --key para volver a traducir las unidades sin cambios, y --estimate para calcular primero el coste de la configuración. Si reintentas el envío, debes usar los mismos parámetros de etapa.

Para añadir un idioma nuevo, completa primero las actualizaciones habituales del origen para los destinos existentes. Después, añádelo a targetLocales, comprueba lingo push --backfill-missing --estimate y solicita el relleno de destinos sin cambiar la revisión del origen. Añadir un idioma detalla esa secuencia hasta las comprobaciones de la aplicación. Eliminar un idioma impide que se seleccione en el futuro, pero no borra los archivos. No uses la purga de idiomas en catálogos XCStrings compartidos.

Recoge los resultados y recupera las tareas #

Sin la opción de espera, conserva el checkout y el puntero local del equipo hasta que pull recupere la salida. Otro push puede sustituir ese puntero. Con la opción de espera, comprueba los resultados fallidos o parcialmente fallidos y los archivos que se hayan descargado realmente. La espera termina cuando todos los destinos sin finalizar están pendientes de revisión humana; ejecuta pull cuando termine el equipo de revisión. No edites los destinos durante la recogida directa con espera, ya que no realiza la comparación actualizada de las modificaciones locales que hace pull.

Para reintentar un 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 aparece en la salida y después comprueba el resultado. 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 completada y sustituye una fallida por una tarea nueva.