ai-i18n-tools

🌐

Strings da UI

Extraia chamadas t() de JS, TS e Astro. Gere JSON plano por localidade para i18next ou pesquisa SSG estática.

📄

Documentos

Traduza páginas Markdown, MDX e Astro para VitePress, Starlight, Docusaurus, Nextra, Fumadocs e sites estáticos simples.

📦

Pacotes JSON

JSON de localidade aninhada quando a cópia da UI reside fora das chamadas t() de origem — rótulos de tema, catálogos e substituições de aplicativos.

🔄

Cache inteligente

Cache SQLite compartilhado em cada pipeline. Apenas segmentos novos ou alterados são enviados ao modelo em novas execuções.

🔌

Independente de provedor

Predefinições integradas para as principais APIs LLM, além de endpoints personalizados compatíveis com OpenAI. Substitua o provedor ativo com -P.

⚡

Um comando de sincronização

Execute extract, translate-ui, translate-svg, translate-docs e translate-json na ordem correta a partir de uma única configuração.

Instalação rápida

O pacote publicado é somente ESM. Node.js >=22.16.0 é necessário.

bash

pnpm add ai-i18n-tools
# Set API key for your active provider — see preset table (default init: openrouter)
export OPENROUTER_API_KEY=sk-or-v1-your-key-here
ai-i18n-tools init [-P <provider>]
ai-i18n-tools sync

Qual pipeline devo usar?

Seu conteúdo	Comando
O código-fonte usa `t()`	Strings de UI — `extract` / `translate-ui`
Páginas localizadas ou sites de documentos	Documentos — `translate-docs`
Arquivos de localidade JSON aninhados autônomos	JSON — `translate-json`

Seu conteúdo

Comando

O código-fonte usa t()

Strings de UI — extract / translate-ui

Páginas localizadas ou sites de documentos

Documentos — translate-docs

Arquivos de localidade JSON aninhados autônomos

JSON — translate-json

As ilustrações SVG usam um caminho translate-svg separado — não docs[].contentPaths. Consulte O que é ai-i18n-tools? para uma comparação completa.

Explorar a documentação

Guia — modos de tradução, instalação, início rápido e integrações de framework

Integrações — VitePress, Nextra, Fumadocs, Docusaurus e Astro

Provedores e modelos — predefinições, cadeias de fallback e substituições -P

Referência da CLI — todos os comandos, sinalizadores e fluxos de trabalho

Configuração — esquema ai-i18n-tools.config.json completo

Exemplos — nove projetos de demonstração executáveis com npx degit

Arquitetura — componentes internos, API programática e pontos de extensão

Integrando o pacote em seu próprio projeto? Comece com AI Agent Context. O README do repositório é uma página de destino curta do GitHub/npm que direciona para cá para obter detalhes.

ai-i18n-toolsTraduza aplicativos e documentos com qualquer LLM