Référence de la CLI

Exécutez ai-i18n-tools <command> --help pour chaque indicateur de commande. Les pages de groupe ci-dessous ajoutent un contexte, des options clés et des liens vers des guides de sujet.

Présentation des commandes

Premiers pas

Commande	Résumé
version	Affiche la version et l'horodatage de construction de la CLI.
init	Écrivez une configuration de démarrage ; -t sélectionne un modèle d'armature.
help	Afficher l'aide pour une sous-commande.

Modèles et langues

Commande	Résumé
check-models	Valide les identifiants de modèle configurés par rapport au fournisseur actif.
list-models	Liste les modèles annoncés par le fournisseur actif.
bench-models	Benchmark des modèles configurés sur un échantillon de traduction.
list-languages	Liste le catalogue des langues d'interface utilisateur intégrées.

Chaînes d'interface utilisateur

Commande	Résumé
extract	Met à jour strings.json à partir de littéraux source et de marqueurs HTML.
mark-html	Insère des marqueurs data-i18n* dans les fichiers HTML.
migrate-intlayer	Importer les dictionnaires Intlayer .content.ts et réécrire les sites useIntlayer / getIntlayer simples en t().
generate-ui-languages	Écrit ui-languages.json à partir de locales de configuration.
translate-ui	Traduit les chaînes d'interface utilisateur (strings.json → JSON de locale).
sync-ui	Extrait, puis traduit les chaînes d'interface utilisateur.
proofread-ui	Extrait, puis examine les chaînes d'interface utilisateur de la locale source à l'aide d'un LLM.
export-ui-xliff	Exporte strings.json vers XLIFF 2.0.

Documents

Commande	Résumé
translate-docs	Traduit le markdown, le MDX, .astro et les catalogues de framework.
write-heading-ids	Insère des lignes d'ancre HTML avant les en-têtes ATX.
check-markdown	Analyse le markdown/MDX pour les problèmes de délimiteur et d'accentuation.

JSON et SVG

Commande	Résumé
translate-json	Traduit le JSON imbriqué par blocs de configuration json[].
translate-svg	Traduit les fichiers SVG configurés dans config.svg.

Workflows et rapports

Commande	Résumé
sync	Exécute l'extraction + l'interface utilisateur + le SVG + les documents + le JSON dans un seul pipeline.
status	Affiche la couverture des traductions de l'interface utilisateur, de la documentation et du JSON.
statistics	Affiche les statistiques du cache et de strings.json.
usage	Afficher les jetons et les coûts des appels API du modèle enregistrés.

Maintenance du cache

Commande	Résumé
cleanup	Élimine les lignes de cache obsolètes/orphelines/de paramètres régionaux non configurés et repeuple les problèmes de markdown.
clean-temp	Trouve et supprime les sauvegardes *.log, *.tmp et du cache.
purge-locale	Supprime les lignes de cache et les artefacts générés pour les paramètres régionaux.

Tableau de bord et glossaire

Commande	Résumé
dashboard (dash)	Lance l'interface utilisateur web du tableau de bord de traduction.
glossary-generate	Écrit un modèle glossary-user.csv vide.

Synopsis

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

Options racine et globales

Option	Portée	Description
-V / --version	Programme racine	Affiche le numéro de version et l'horodatage de compilation (même information que la sous-commande version).
-h / --help	Programme racine	Affiche l'aide pour le programme racine ou pour une sous-commande lorsqu'utilisé avec un nom de commande.
-c / --config <path>	Chaque commande	Chemin du fichier de configuration (par défaut : ai-i18n-tools.config.json).
-v / --verbose	Chaque commande	Journalisation détaillée.
-P / --provider <name>	Chaque commande	Fournisseur LLM actif pour cette exécution ; remplace la clé de configuration provider. Doit être configuré sous providers.
-L / --ui-lang <code>	Chaque commande	Langue de l'interface utilisateur de l'outil (aide CLI, journaux/résumés, tableau de bord) ; source la plus prioritaire. Voir Langue de l'interface utilisateur de l'outil.
-w / --write-logs [path]	Commandes sélectionnées	Affiche la sortie de la console dans un fichier .log (chemin par défaut : sous la racine cacheDir). Câblé uniquement pour translate-docs, translate-json, translate-svg, translate-ui, sync-ui, sync et cleanup.
--debug-failed	Commandes de traduction	Écrit les journaux FAILED-TRANSLATION sous la racine cacheDir pour chaque vérification de traduction ignorée (script, analyse ou qualité incorrects), y compris les solutions de repli — pas seulement lorsque tous les modèles échouent. Les erreurs d'API du fournisseur ou de corps vide s'affichent sur la console (une fois par modèle et par message d'erreur) et n'écrivent pas ces fichiers. S'applique à translate-ui, translate-docs, translate-json, translate-svg, sync-ui, sync et cleanup.

Aide par commande

Utilisation	Description
ai-i18n-tools <command> --help	Toutes les options pour cette commande.
ai-i18n-tools help <command>	Même sortie que <command> --help.

Paramètres régionaux cibles (-l / --locale)

Commandes	Comportement
translate-docs, translate-json, translate-svg, translate-ui, sync, sync-ui, export-ui-xliff	-l / --locale <codes> — codes BCP-47 cibles séparés par des virgules (par exemple, de,fr,pt-BR). Si omis, les valeurs par défaut proviennent de la configuration (les blocs json[] peuvent également définir targetLocales par bloc ; les étapes de l’interface utilisateur utilisent targetLocales moins sourceLocale).
proofread-ui	-l / --locale <code> — locale source unique à examiner (par défaut : configuration sourceLocale).