Referência da CLI

Execute ai-i18n-tools <command> --help para cada flag em um comando. As páginas abaixo adicionam contexto, opções-chave e links para guias de tópicos.

Visão geral do comando

Primeiros passos

Comando	Resumo
version	Imprime a versão da CLI e o carimbo de data/hora da compilação.
init	Grava uma configuração inicial; -t seleciona um modelo de scaffold.
help	Exibir ajuda para um subcomando.

Modelos e idiomas

Comando	Resumo
check-models	Valida os IDs de modelo configurados em relação ao provedor ativo.
list-models	Lista os modelos anunciados pelo provedor ativo.
bench-models	Avalia modelos configurados em uma tradução de amostra.
list-languages	Lista o catálogo de idiomas da UI incluído.

Strings da UI

Comando	Resumo
extract	Atualiza strings.json a partir de literais de origem e marcadores HTML.
mark-html	Insere marcadores data-i18n* em arquivos HTML.
migrate-intlayer	Importe dicionários .content.ts do Intlayer e reescreva sites useIntlayer / getIntlayer simples para t().
generate-ui-languages	Grava ui-languages.json a partir de localidades de configuração.
translate-ui	Traduz strings da UI (strings.json → JSON de localidade).
sync-ui	Extrai e, em seguida, traduz strings da UI.
proofread-ui	Extrai e, em seguida, revisa strings da UI de localidade de origem com LLM.
export-ui-xliff	Exporta strings.json para XLIFF 2.0.

Documentos

Comando	Resumo
translate-docs	Traduz markdown, MDX, .astro e catálogos de framework.
write-heading-ids	Insere linhas de âncora HTML antes dos títulos ATX.
check-markdown	Escaneia markdown/MDX em busca de problemas de delimitador e ênfase.

JSON e SVG

Comando	Resumo
translate-json	Traduz JSON aninhado por blocos de configuração json[].
translate-svg	Traduz arquivos SVG configurados em config.svg.

Fluxos de trabalho e relatórios

Comando	Resumo
sync	Executa extração + UI + SVG + docs + JSON em um pipeline.
status	Imprime a cobertura de tradução da UI, da documentação e do JSON.
statistics	Imprime estatísticas de cache e strings.json.
usage	Imprimir tokens e custos registrados de chamadas de API do modelo.

Manutenção de cache

Comando	Resumo
cleanup	Remove linhas de cache obsoletas/órfãs/com localidade não configurada e repopula problemas de markdown.
clean-temp	Encontra e exclui backups de *.log, *.tmp e cache.
purge-locale	Remove linhas de cache e artefatos gerados para o(s) idioma(s).

Painel e glossário

Comando	Resumo
dashboard (dash)	Inicia a interface de usuário web do Painel de Tradução.
glossary-generate	Grava um modelo glossary-user.csv vazio.

Sinopse

ai-i18n-tools version
ai-i18n-tools init [-t ui-markdown|ui-docusaurus|ui-starlight|ui-vitepress|ui-nextra|ui-fumadocs|ui-astro-website|ui-json-bundles] [-o path] [-P <provider>] [--with-translate-ignore]
ai-i18n-tools help [command]
ai-i18n-tools check-models
ai-i18n-tools list-models
ai-i18n-tools bench-models [--model <ids>] [--text <text>|--file <path>] [--source <locale>] [--target <locale>]
ai-i18n-tools list-languages [search]
ai-i18n-tools extract
ai-i18n-tools mark-html [paths...] [--write]
ai-i18n-tools migrate-intlayer [paths...] [--write] [--report <path>] [--content-glob <glob>] [--t-import <specifier>]
ai-i18n-tools generate-ui-languages [--master path] [--dry-run]
ai-i18n-tools translate-ui …
ai-i18n-tools sync-ui …
ai-i18n-tools proofread-ui …
ai-i18n-tools export-ui-xliff …
ai-i18n-tools translate-docs …
ai-i18n-tools write-heading-ids …
ai-i18n-tools check-markdown [-p|--path <path>] [-f|--file <path>] [--json] [--no-cache]
ai-i18n-tools translate-json …
ai-i18n-tools translate-svg …
ai-i18n-tools sync …
ai-i18n-tools status …
ai-i18n-tools statistics …
ai-i18n-tools usage …
ai-i18n-tools cleanup …
ai-i18n-tools clean-temp …
ai-i18n-tools purge-locale -l <code> [-l <code> …] [--dry-run] [-y|--yes] [-f|--force] [--keep-files] [--backup <path>]
ai-i18n-tools dashboard …
ai-i18n-tools glossary-generate

Opções raiz e globais

Opção	Escopo	Descrição
-V / --version	Programa raiz	Exibe o número da versão e o carimbo de data da compilação (mesmas informações do subcomando version).
-h / --help	Programa raiz	Exibe ajuda para o programa raiz ou para um subcomando quando usado com um nome de comando.
-c / --config <path>	Todos os comandos	Caminho do arquivo de configuração (padrão: ai-i18n-tools.config.json).
-v / --verbose	Todos os comandos	Registro detalhado (verbose logging).
-P / --provider <name>	Todo comando	Provedor de LLM ativo para esta execução; substitui a chave provider da configuração. Deve ser configurado em providers.
-L / --ui-lang <code>	Todos os comandos	Idioma da própria interface do usuário da ferramenta (ajuda da CLI, logs/resumos, painel); fonte de maior prioridade. Consulte Idioma da interface do usuário da ferramenta.
-w / --write-logs [path]	Comandos selecionados	Redireciona a saída do console para um arquivo .log (caminho padrão: sob a raiz cacheDir). Conectado apenas para translate-docs, translate-json, translate-svg, translate-ui, sync-ui, sync e cleanup.
--debug-failed	Comandos de tradução	Grava logs FAILED-TRANSLATION sob a raiz cacheDir para cada verificação de tradução descartada (script, análise ou qualidade incorretos), incluindo fallbacks — não apenas quando todos os modelos falham. Erros de API do provedor / corpo vazio são impressos no console (uma vez por modelo e mensagem de erro) e não gravam esses arquivos. Aplica-se a translate-ui, translate-docs, translate-json, translate-svg, sync-ui, sync e cleanup.

Ajuda por comando

Uso	Descrição
ai-i18n-tools <command> --help	Todas as opções para esse comando.
ai-i18n-tools help <command>	Saída idêntica à de <command> --help.

Localidades de destino (-l / --locale)

Comandos	Comportamento
translate-docs, translate-json, translate-svg, translate-ui, sync, sync-ui, export-ui-xliff	-l / --locale <codes> — códigos BCP-47 de destino separados por vírgulas (por exemplo, de,fr,pt-BR). Quando omitido, os padrões vêm da configuração (blocos json[] também podem definir targetLocales por bloco; as etapas da UI usam targetLocales menos sourceLocale).
proofread-ui	-l / --locale <code> — local de origem único para revisar (padrão: configuração sourceLocale).