Skip to content

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 ​

CommandeRésumé
versionAffiche la version et l'horodatage de construction de la CLI.
upgradeMettre à niveau l'installation en cours vers la dernière version publiée.
initÉcrivez une configuration de démarrage ; -t sélectionne un modèle d'armature.
doctorVérifiez que la configuration, les chemins, les fournisseurs et l'environnement sont prêts à traduire.
helpAfficher l'aide pour une sous-commande.

Modèles et langues ​

CommandeRésumé
check-modelsValide les identifiants de modèle configurés par rapport au fournisseur actif.
list-modelsListe les modèles annoncés par le fournisseur actif.
suggest-modelsClassez les modèles de chat par qualité de traduction ou par prix et rédigez éventuellement translationModels.
bench-modelsBenchmark des modèles configurés sur un échantillon de traduction.
list-languagesListe le catalogue des langues d'interface utilisateur intégrées.

Chaînes d'interface utilisateur ​

CommandeRésumé
extractMet à jour strings.json à partir de littéraux source et de marqueurs HTML.
mark-htmlInsère des marqueurs data-i18n* dans les fichiers HTML.
migrate-intlayerImporter les dictionnaires Intlayer .content.ts et réécrire les sites useIntlayer / getIntlayer simples en t().
translate-intlayerTraduire les feuilles de locale manquantes/obsolètes dans les dictionnaires Intlayer .content.ts sur place.
generate-ui-languagesÉcrit ui-languages.json à partir de locales de configuration.
translate-uiTraduit les chaînes d'interface utilisateur (strings.json → JSON de locale).
sync-uiExtrait, puis traduit les chaînes d'interface utilisateur.
proofread-uiExtrait, puis examine les chaînes d'interface utilisateur de la locale source à l'aide d'un LLM.
export-ui-xliffExporte strings.json vers XLIFF 2.0.

Documents ​

CommandeRésumé
translate-docsTraduit le markdown, le MDX, .astro et les catalogues de framework.
write-heading-idsInsère des lignes d'ancre HTML avant les en-têtes ATX.
check-markdownAnalyse le markdown/MDX pour les problèmes de délimiteur et d'accentuation.

JSON et SVG ​

CommandeRésumé
translate-jsonTraduit le JSON imbriqué par blocs de configuration json[].
translate-svgTraduit les fichiers SVG configurés dans config.svg.

Workflows et rapports ​

CommandeRésumé
syncExécute l'extraction + l'interface utilisateur + le SVG + les documents + le JSON dans un seul pipeline.
statusAffiche la couverture des traductions de l'interface utilisateur, de la documentation et du JSON.
statisticsAffiche les statistiques du cache et de strings.json.
usageAfficher les jetons et les coûts des appels API du modèle enregistrés.

Maintenance du cache ​

CommandeRé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-tempTrouve et supprime les sauvegardes *.log, *.tmp et du cache.
purge-localeSupprimez les lignes de cache et les artefacts générés pour les paramètres régionaux.

Tableau de bord et glossaire ​

CommandeRé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 ​

bash
ai-i18n-tools version
ai-i18n-tools upgrade [--yes]
ai-i18n-tools init [-t ui-markdown|ui-docusaurus|ui-starlight|ui-vitepress|ui-nextra|ui-fumadocs|ui-astro-website|ui-plain-html|docs-plain-html|docs-markdown|ui-json-bundles|ui-python|ui-python-gettext|ui-python-django|ui-python-flask|ui-dotnet|ui-dotnet-resx] [-o path] [-P <provider>] [--namespace <name>] [--with-readme] [--with-translate-ignore]
ai-i18n-tools doctor [--local] [--strict] [--json] [--fix-gitignore]
ai-i18n-tools migrate-python-i18n [--write] [--report <path>]
ai-i18n-tools migrate-dotnet-i18n [--write] [--wrap] [--report <path>] [--ui-block <selector>]
ai-i18n-tools help [command]
ai-i18n-tools check-models
ai-i18n-tools list-models
ai-i18n-tools suggest-models [--quality | --price] [--top <n>] [--json] [--apply] [--list] [--max-price <usd>] [--min-delta <points>] [--refresh]
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 translate-intlayer [paths...] [-l <codes>] [--ui-block <selector>] [--dry-run] [-j <n>]
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 ​

OptionPortéeDescription
-V / --versionProgramme racineAffiche le numéro de version et l'horodatage de compilation (même information que la sous-commande version).
-h / --helpProgramme racineAffiche l'aide pour le programme racine ou pour une sous-commande lorsqu'utilisé avec un nom de commande.
-c / --config <path>Chaque commandeChemin du fichier de configuration (par défaut : ai-i18n-tools.config.json).
-v / --verboseChaque commandeJournalisation détaillée.
-P / --provider <name>Chaque commandeFournisseur LLM actif pour cette exécution ; remplace la clé de configuration provider. Doit être configuré sous providers.
-L / --ui-lang <code>Chaque commandeLangue de l'interface utilisateur propre à l'outil (aide de la CLI, journaux/résumés, tableau de bord) ; source de la plus haute priorité. L'option d'aide répertorie les codes fournis. L'omission de <code> affiche cette liste et quitte. Voir Langue de l'interface utilisateur de l'outil.
-w / --write-logs [path]Commandes sélectionnéesAffiche 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-failedCommandes 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 ​

UtilisationDescription
ai-i18n-tools <command> --helpToutes les options pour cette commande.
ai-i18n-tools help <command>Même sortie que <command> --help.

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

CommandesComportement
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).

Publié sous licence MIT.