Skip to content

CLI — Manutenção de cache ​

cleanup ​

Sinopse: ai-i18n-tools cleanup [--dry-run] [--backup <path>]

Limpa a tabela markdown_source_issues inteira, então executa sync --force-update (extração, UI, SVG, documentos e translate-json quando ativado) para que os problemas de markdown sejam repopulados para os documentos atualmente configurados. Em seguida:

  • remove linhas de segmento obsoletas (last_hit_at nulo / caminho de arquivo vazio);
  • descarta linhas file_tracking cujo caminho de origem resolvido está faltando no disco;
  • remove linhas de tradução cujos metadados filepath apontam para um arquivo ausente;
  • poda linhas translation_failures órfãs;
  • descarta linhas de cache para localidades ausentes da configuração (sourceLocale, raiz targetLocales e qualquer docs[] / json[] targetLocales por bloco).

Somente cache para localidades desativadas — documentos gerados, arquivos de UI planos e entradas strings.json são deixados intactos (use purge-locale para remover esses). Registra contagens de poda após a sincronização (segmentos obsoletos, file_tracking órfãos, traduções órfãs, falhas órfãs, localidades não configuradas) mais a contagem de limpeza inicial de problemas de markdown.

Opções principais: --dry-run, --backup

--backup <path> grava um backup SQLite nesse caminho antes das modificações (nenhum backup, a menos que este sinalizador esteja definido).


clean-temp ​

Sinopse: ai-i18n-tools clean-temp [-r | --root <path>] [-f | --force] [--dry-run]

Nenhuma configuração. Percorre uma árvore de diretórios (padrão: diretório de trabalho atual) para *.log, *.tmp e cache.db.backup*.sqlite, imprime caminhos ./… como find -print. Com correspondências: solicita Delete these files? (y/n), a menos que -f / --force (excluir sem prompt). Sem correspondências: sai sem solicitar. --dry-run: apenas lista, sem prompt ou exclusões (substitui --force).

Opções principais: -r / --root, -f / --force, --dry-run


purge-locale ​

Sinopse: ai-i18n-tools purge-locale -l <code> [-l <code> …] [options]

Excluir todas as linhas em cache para o(s) local(is) fornecido(s) de translations, file_tracking e translation_failures, e os artefatos gerados para esse local: documentos traduzidos (saídas .md / .mdx / .astro resolvidas de docs[], incluindo saídas órfãs cuja origem foi removida — encontradas ao varrer a árvore de saída de cada bloco, exceto quando um pathTemplate personalizado é configurado), o arquivo de UI plano por local (<flatOutputDir>/<locale>.json), o .po / .mo Gettext do local quando configurado, o satélite .resx do local ({baseName}.{culture}.resx; o {baseName}.resx neutro permanece), e as entradas do local em strings.json.

Localidades são passadas via -l / --locale repetível (normalizado para BCP-47). Imprime contagens por localidade (linhas de cache, documentos, entradas strings.json, arquivo plano); avisa (não gera erro) para localidades sem nada para purgar. Solicita confirmação, a menos que -y / --yes / -f / --force. --dry-run: relata contagens e os arquivos que seriam removidos, não exclui nada. --keep-files: purga apenas o cache SQLite, deixando arquivos gerados e strings.json intocados. Nenhum backup SQLite é feito, a menos que --backup <path> seja passado, o que escreve um backup para esse caminho antes da exclusão.

Opções principais: -l / --locale, --dry-run, -y / --yes, -f / --force, --keep-files, --backup

Lançado sob a Licença MIT.