Skip to content

CLI — Flux de travail et rapports ​

sync ​

Synopsis : ai-i18n-tools sync [options]

Extraction (si activée), puis traduction de l'interface utilisateur, puis translate-svg lorsque features.translateSVG et config.svg sont définis, puis traduction de la documentation, puis translate-json lorsque features.translateJson et json[] sont définis — sauf si ignoré avec --no-ui, --no-svg, --no-docs ou --no-json.

Principales options : -l, -p / -f, --dry-run, -j, -b, --force, --force-update, --check-cache, --recheck-glossary-warnings, --no-ui, --no-svg, --no-docs, --no-json

--force efface le cache de segments et le suivi des fichiers des documents, JSON et SVG. Il n'est pas transmis à la traduction de l'interface utilisateur ; utilisez translate-ui --force ou sync-ui --force pour retraduire strings.json. --force-update s'applique aux documents, JSON et SVG (pas à l'interface utilisateur). --no-ui, --no-svg, --no-docs et --no-json ignorent cette étape pour une exécution. --file limite les fichiers traduits et réécrit toujours les liens de même niveau en utilisant chaque fichier Markdown dans le bloc de documents. --check-cache est transmis aux documents, JSON et SVG : il revalide les segments mis en cache pour les locales avec un script natif imposé, même lorsque le suivi des fichiers ignorerait. La phase des documents transmet également --emphasis-placeholders (même signification que translate-docs). Le global --debug-failed écrit des journaux FAILED-TRANSLATION sous cacheDir pour chaque tentative de modèle rejetée (y compris les replis de script SVG/documents), pas seulement lorsque chaque modèle de la chaîne échoue. --prompt-format n'est pas un indicateur sync ; les étapes des documents et JSON utilisent la valeur par défaut intégrée (json-array).


status ​

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

Lorsque features.translateUIStrings est activé, affiche la couverture de l'interface utilisateur par locale (Translated / Missing / Placeholder issues / Total). Placeholder issues compte les lignes dont la traduction stockée renomme, supprime, invente ou redirige un espace réservé. Ensuite, affiche l'état de la traduction Markdown par fichier × locale (sans filtre --locale ; les locales proviennent de la configuration). Lorsque features.translateJson est activé et que json[] est configuré, affiche également l'état du bundle JSON par bloc. Les listes de locales volumineuses sont divisées en tableaux répétés de jusqu'à n colonnes de locales (par défaut 9) afin que les lignes restent étroites dans le terminal.

Options clés : --max-columns


statistics ​

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

Affiche les statistiques du cache de documentation et de strings.json (mêmes agrégats que Tableau de bord de traduction → Statistiques). --max-columns : nombre maximal de colonnes de locales par tableau modèle × locale (par défaut 6).

Options clés : --max-columns

Voir aussi : Statistiques du tableau de bord


usage ​

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

Affiche les statistiques des appels d'API du modèle enregistré (appels, jetons et coût unique en USD). Le coût est le usage.cost du fournisseur lorsqu'il est présent (y compris 0), sinon providers.<name>.modelPricing pour ce modèle, sinon le providers.<name>.pricing par défaut du fournisseur, sinon le prix catalogue d'entrée et de sortie models.dev pour cet identifiant de modèle. Un coût signalé et un taux de configuration explicite ne sont jamais remplacés. Un coût inconnu reste —, jamais $0.00. Les nouveaux appels stockent le montant ; les lignes plus anciennes qui contiennent des jetons mais aucun coût stocké sont estimées lors de l'exécution du rapport. Il s'agit des mêmes agrégats que dans Tableau de bord de traduction → Utilisation et coûts. Les lignes de détail antérieures à sept jours civils UTC sont regroupées dans des api_totals mensuels ; les rapports combinent les deux tables. --since accepte YYYY-MM-DD, une durée (30m, 1h, 6h, 12h, 24h, 7d, 30d), ou une fenêtre de mois civil (1mo, 2mo, 3mo). --clear supprime les lignes de détail et les totaux mensuels (--older-than est 1mo, 2mo, 3mo, 6mo, 1y ou all ; --dry-run signale le nombre sans supprimer).

Options clés : --since, --provider, --model, --operation, -l / --locale, --outcome, --clear, --older-than, --dry-run

Voir aussi : Utilisation et coûts du tableau de bord

Publié sous licence MIT.