CLI — Flujos de trabajo e informes
sync
Sinopsis: ai-i18n-tools sync [options]
Extraer (si está habilitado), luego traducción de la IU, luego translate-svg cuando features.translateSVG y config.svg están configurados, luego traducción de la documentación, luego translate-json cuando features.translateJson y json[] están configurados, a menos que se omita con --no-ui, --no-svg, --no-docs o --no-json.
Opciones clave: -l, -p / -f, --dry-run, -j, -b, --force, --force-update, --check-cache, --recheck-glossary-warnings, --no-ui, --no-svg, --no-docs, --no-json
--force borra la caché de segmentos y el seguimiento de archivos de documentos, JSON y SVG. No se reenvía a la traducción de la IU; use translate-ui --force o sync-ui --force para volver a traducir strings.json. --force-update se aplica a documentos, JSON y SVG (no a la IU). --no-ui, --no-svg, --no-docs y --no-json omiten ese paso para una ejecución. --file limita qué archivos se traducen y aún reescribe los enlaces de hermanos planos utilizando cada archivo markdown en el bloque de documentos. --check-cache se reenvía a documentos, JSON y SVG: revalida los segmentos en caché para configuraciones regionales con un script nativo forzado incluso cuando el seguimiento de archivos lo omitiría. La fase de documentos también reenvía --emphasis-placeholders (mismo significado que translate-docs). --debug-failed global escribe registros FAILED-TRANSLATION en cacheDir para cada intento de modelo descartado (incluyendo las alternativas de script de SVG/documentos), no solo cuando todos los modelos de la cadena fallan. --prompt-format no es un indicador sync; los pasos de documentos y JSON usan el valor predeterminado integrado (json-array).
status
Sinopsis: ai-i18n-tools status [--max-columns <n>]
Cuando features.translateUIStrings está activado, imprime la cobertura de la interfaz de usuario por configuración regional (Translated / Missing / Placeholder issues / Total). Placeholder issues cuenta las filas cuya traducción almacenada renombra, elimina, inventa o redirige un marcador de posición. Luego imprime el estado de la traducción de markdown por archivo × configuración regional (sin filtro --locale; las configuraciones regionales provienen de la configuración). Cuando features.translateJson está activado y json[] está configurado, también imprime el estado del paquete JSON por bloque. Las listas grandes de configuraciones regionales se dividen en tablas repetidas de hasta n columnas de configuración regional (predeterminado 9) para que las líneas permanezcan estrechas en la terminal.
Opciones clave: --max-columns
statistics
Sinopsis: ai-i18n-tools statistics [--max-columns <n>]
Imprime las estadísticas de la caché de documentación y strings.json (los mismos agregados que Panel de traducción → Estadísticas). --max-columns: columnas de configuración regional máximas por modelo × tabla de configuración regional (predeterminado 6).
Opciones clave: --max-columns
Véase también: Estadísticas del panel
usage
Sinopsis: ai-i18n-tools usage [--since <when>] [--provider <name>] [--model <id>] [--operation <name>] [-l <code>] [--outcome accepted|discarded] [--clear] [--older-than <when>] [--dry-run]
Imprime las estadísticas de llamadas a la API del modelo registrado (llamadas, tokens y un coste único en USD). El coste es el usage.cost del proveedor cuando está presente (incluido 0), de lo contrario es providers.<name>.modelPricing para ese modelo, de lo contrario es el valor predeterminado providers.<name>.pricing de todo el proveedor, y de lo contrario es el precio de lista de entrada y salida de models.dev para ese ID de modelo. Un coste notificado y una tarifa de configuración explícita nunca se reemplazan. El coste desconocido permanece como —, nunca como $0.00. Las llamadas nuevas almacenan la cantidad; las filas más antiguas que tienen tokens pero no tienen un coste almacenado se estiman cuando se ejecuta el informe. Los mismos agregados que en el Panel de traducción → Uso y costes. Las filas de detalle con más de siete días naturales UTC se consolidan en api_totals mensuales; los informes combinan ambas tablas. --since acepta YYYY-MM-DD, una duración (30m, 1h, 6h, 12h, 24h, 7d, 30d) o una ventana de mes natural (1mo, 2mo, 3mo). --clear elimina las filas de detalle y los totales mensuales (--older-than es 1mo, 2mo, 3mo, 6mo, 1y o all; --dry-run informa del recuento sin eliminar).
Opciones clave: --since, --provider, --model, --operation, -l / --locale, --outcome, --clear, --older-than, --dry-run
Véase también: Uso y costos del panel