¿Qué es ai-i18n-tools?

ai-i18n-tools es una herramienta de línea de comandos y un kit de herramientas que le ayuda a traducir su aplicación y documentación utilizando su proveedor de LLM preferido. Usted controla todo desde un único archivo de configuración, eligiendo qué funciones de traducción habilitar. Utilice el comando "sync" para ejecutar los modos que necesite de una sola vez.

Modos de traducción

• Cadenas de interfaz de usuario — Extrae llamadas t("…") (y marcadores similares) del código fuente JS/TS y escribe archivos JSON planos por configuración regional para i18next o búsqueda estática. Comandos: extract, translate-ui. Guía: Cadenas de interfaz de usuario.
• Documentos — Traduce páginas Markdown, MDX y .astro listadas en docs[].contentPaths. Funciona con VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro y otros sitios de documentación estática. Comando: translate-docs. Guía: Documentos.
• JSON — Traduce paquetes de configuración regional JSON anidados (etiquetas de tema, anulaciones de i18n, copias de aplicaciones que no están en el código fuente) definidos en json[] de nivel superior. Comando: translate-json. Guía: JSON.
• SVG — Traduce el texto visible dentro de las ilustraciones SVG (<text>, <title>, <desc>) y escribe un archivo de salida por configuración regional. Separado de la traducción de documentos: translate-docs no modifica los activos SVG. Comando: translate-svg. Guía: Traducción de SVG.

Los cuatro modos utilizan el proveedor de LLM activo, comparten el mismo archivo de configuración y reutilizan una caché de SQLite para que las nuevas ejecuciones solo envíen texto nuevo o modificado al modelo.

¿Cuál debo usar?

Su contenido	Modo	Comando
El código fuente utiliza marcadores t() o HTML data-i18n	Cadenas de interfaz de usuario	extract / translate-ui
Páginas localizadas o sitios de documentación	Documentos	translate-docs
Archivos de configuración regional JSON anidados independientes	JSON	translate-json
Diagramas o ilustraciones con etiquetas en SVG	SVG	translate-svg

Muchos proyectos combinan modos, por ejemplo, cadenas de interfaz de usuario más documentos para un sitio de VitePress, o documentos más SVG para guías ilustradas. Consulte Inicio rápido para plantillas de andamiaje y Configuración para el esquema de configuración completo.

Ejemplos

El repositorio incluye proyectos de ejemplo ejecutables en examples/, cada uno con su propia configuración, salidas de configuración regional confirmadas y README. Puede explorar archivos traducidos sin una clave API; la repetición de la traducción requiere una clave de proveedor (consulte Proveedores y modelos).

Ejemplo	Lo que muestra
console-app	Aplicación de extremo a extremo más pequeña: cadenas de interfaz de usuario t() más traducción de README
nextjs-app	Interfaz de usuario de Next.js, plurales, SVG, documentos anidados de Docusaurus, README plano, panel de control
docusaurus-docs	Sitio de documentación independiente de Docusaurus
astro-website	Sitio de marketing de Astro: traducción de HTML de página completa más cadenas t()
astro-docs	Sitio de documentación de Astro Starlight
vitepress-docs	Documentos de VitePress más catálogo de temas
nextra-docs	Documentos de Nextra más etiquetas de barra lateral _meta.ts y diccionario de temas
fumadocs-docs	Documentos de Fumadocs más etiquetas de barra lateral meta.json y catálogo de interfaz de usuario
multi-provider	Comparar proveedores de LLM en el mismo documento
test-markdown	Pruebas de estrés de la canalización de Markdown (CJK, Devanagari, casos extremos)

Consulte Ejemplos para comandos de copia npx degit y una guía de elección.

Próximos pasos

1. Instalación — instala el paquete y establece tu clave API de proveedor.
2. Inicio rápido — crea una configuración y ejecuta tu primera traducción.
3. Proveedores y modelos — elige un proveedor, una cadena de reserva de modelo y una anulación de -P.