Skip to content

CLI — Fluxos de trabalho e relatórios ​

sync ​

Sinopse: ai-i18n-tools sync [options]

Extrai (se ativado), depois tradução da IU, depois translate-svg quando features.translateSVG e config.svg são definidos, depois tradução da documentação, depois translate-json quando features.translateJson e json[] são definidos — a menos que seja ignorado com --no-ui, --no-svg, --no-docs ou --no-json.

Opções principais: -l, -p / -f, --dry-run, -j, -b, --force, --force-update, --check-cache, --recheck-glossary-warnings, --no-ui, --no-svg, --no-docs, --no-json

--force limpa o cache de segmentos e o rastreamento de arquivos de docs, JSON e SVG. Não é encaminhado para a tradução da UI; use translate-ui --force ou sync-ui --force para retraduzir strings.json. --force-update se aplica a docs, JSON e SVG (não à UI). --no-ui, --no-svg, --no-docs e --no-json pulam essa etapa para uma execução. --file limita quais arquivos são traduzidos e ainda reescreve links de irmãos planos usando cada arquivo markdown no bloco de docs. --check-cache é encaminhado para docs, JSON e SVG: ele revalida segmentos em cache para localidades com um script nativo imposto, mesmo quando o rastreamento de arquivos pularia. A fase de docs também encaminha --emphasis-placeholders (mesmo significado que translate-docs). O --debug-failed global escreve logs FAILED-TRANSLATION em cacheDir para cada tentativa de modelo descartada (incluindo fallbacks de script SVG/docs), não apenas quando todos os modelos na cadeia falham. --prompt-format não é um flag sync; as etapas de docs e JSON usam o padrão embutido (json-array).


status ​

Sinopse: ai-i18n-tools status [--max-columns <n>]

Quando features.translateUIStrings está ativado, imprime a cobertura da interface do usuário por localidade (Translated / Missing / Placeholder issues / Total). Placeholder issues conta as linhas cuja tradução armazenada renomeia, descarta, inventa ou redireciona um placeholder. Em seguida, imprime o status da tradução markdown por arquivo × localidade (sem filtro --locale; as localidades vêm da configuração). Quando features.translateJson está ativado e json[] está configurado, também imprime o status do pacote JSON por bloco. Listas grandes de localidades são divididas em tabelas repetidas de até n colunas de localidade (padrão 9) para que as linhas permaneçam estreitas no terminal.

Opções principais: --max-columns


statistics ​

Sinopse: ai-i18n-tools statistics [--max-columns <n>]

Imprime o cache da documentação e as estatísticas strings.json (mesmos agregados que Painel de Tradução → Estatísticas). --max-columns: máximo de colunas de localidade por tabela de modelo × localidade (padrão 6).

Opções principais: --max-columns

Veja também: Estatísticas do painel


usage ​

Sinopse: ai-i18n-tools usage [--since <when>] [--provider <name>] [--model <id>] [--operation <name>] [-l <code>] [--outcome accepted|discarded] [--clear] [--older-than <when>] [--dry-run]

Exibe estatísticas de chamadas de API do modelo registrado (chamadas, tokens e um custo único em USD). O custo é o usage.cost do provedor quando presente (incluindo 0), caso contrário, é o providers.<name>.modelPricing para aquele modelo, ou então o padrão providers.<name>.pricing de todo o provedor, ou, por fim, o preço de lista de entrada e saída do models.dev para aquele ID de modelo. Um custo relatado e uma taxa de configuração explícita nunca são substituídos. Custos desconhecidos permanecem como —, nunca $0.00. Novas chamadas armazenam o valor; linhas mais antigas que possuem tokens, mas não possuem custo armazenado, são estimadas quando o relatório é executado. Os mesmos agregados do Painel de Tradução → Uso e custos. Linhas de detalhes com mais de sete dias corridos em UTC são consolidadas em api_totals mensais; os relatórios combinam ambas as tabelas. --since aceita YYYY-MM-DD, uma duração (30m, 1h, 6h, 12h, 24h, 7d, 30d) ou uma janela de mês civil (1mo, 2mo, 3mo). --clear exclui linhas de detalhes e totais mensais (--older-than é 1mo, 2mo, 3mo, 6mo, 1y ou all; --dry-run relata a contagem sem excluir).

Opções principais: --since, --provider, --model, --operation, -l / --locale, --outcome, --clear, --older-than, --dry-run

Ver também: Uso e custos do painel

Lançado sob a Licença MIT.