CLI – UI-Zeichenfolgen
extract
Synopsis: ai-i18n-tools extract
Aktualisiert strings.json aus t("…") / i18n.t("…")-Literalen, optionaler package.json-Beschreibung und optionalen gebündelten Master-englishName-Einträgen, wenn includeUiLanguageEnglishNames aktiviert ist (siehe ui.uiExtractor; liest nicht languagesManifestPath). Generiert auch ui-languages.json unter languagesManifestPath neu. Wenn .html / .htm in ui.uiExtractor.extensions aufgeführt sind, erfasst es auch data-i18n / data-i18n-title / data-i18n-placeholder-Marker-Strings aus HTML. Erfordert nicht-leeres ui.sourceRoots. Ruft kein LLM auf.
Siehe auch: Übersicht über UI-Strings, Reine HTML-Anwendungen
migrate-intlayer
Synopsis: ai-i18n-tools migrate-intlayer [paths...] [--write] [--report <path>] [--content-glob <glob>] [--t-import <specifier>]
Importiert Intlayer-*.content.ts-Wörterbücher in strings.json und flache Locale-Dateien und schreibt einfache useIntlayer-/getIntlayer-Aufrufstellen zu t('English source') um. Standardmäßig im Trockenlauf (der Bericht wird trotzdem geschrieben). --write füllt den Katalog und wendet sichere Umschreibungen an. Ruft kein LLM auf.
Der Bericht dient als Übergabedokument für alles, was --write zurücklässt, und endet mit einer Schritt-für-Schritt-To-do-Liste, die die weiteren Arbeitsschritte strukturiert: ein konkreter t()- oder JSX-Aufruf für jede manuelle Stelle, die import { t }-Zeile, Wörterbuchdateien und IntlayerProvider-Überreste, die anschließend gelöscht werden müssen, Ausgangszeichenfolgen, die extract und anschließend translate-ui benötigen, sowie ein i18next-Laufzeit-Bootstrap, um das i18n-Modul der App zu überschreiben. Die Locale-Steuerung muss sowohl i18n.changeLanguage als auch loadLocale aufrufen. extract schreibt ui-languages.json, das von diesem Bootstrap importiert wird. Bearbeiten Sie strings.json, die flachen Locale-Dateien oder ui-languages.json nicht manuell.
Schlüsseloptionen: --write, --report, --content-glob (Standard **/*.content.ts), --t-import
Siehe auch: Migration von Intlayer
mark-html
Synopsis: ai-i18n-tools mark-html [paths...] [--write]
Fügt bloße data-i18n / data-i18n-title / data-i18n-placeholder-Marker in HTML ein, sodass der Quelltext einmal (auf dem Element selbst) geschrieben wird. Scannt die angegebenen Dateien/Verzeichnisse/Globs (Standard: .html / .htm unter ui.sourceRoots). Standardmäßig Trockenlauf (meldet die Anzahl der hinzugefügten Elemente pro Datei und alle Elemente mit gemischtem Inhalt, die eine manuelle <span data-i18n> benötigen); --write wendet Änderungen an. Idempotent, berücksichtigt data-i18n-ignore (überspringt das Element und seinen Unterbaum), berührt niemals codeähnliche Elemente (code, pre, kbd, samp, var) oder leeren/nur-numerischen Text und gibt niemals einen bewerteten Marker aus. Ruft kein LLM auf.
Schlüsseloptionen: --write
Siehe auch: HTML für die Übersetzung markieren
generate-ui-languages
Synopsis: ai-i18n-tools generate-ui-languages [--master <path>] [--dry-run]
Schreibt ui-languages.json nach languagesManifestPath (Standard: {ui.flatOutputDir}/ui-languages.json) unter Verwendung von sourceLocale + targetLocales und dem gebündelten data/ui-languages-complete.json (oder --master). Warnt und gibt TODO-Platzhalter für Lokale aus, die in der Masterdatei fehlen. Wenn Sie ein vorhandenes Manifest mit angepassten label- oder englishName-Werten haben, werden diese durch die Standardwerte des Masterkatalogs ersetzt – überprüfen und passen Sie die generierte Datei anschließend an.
Schlüsseloptionen: --master, --dry-run
translate-ui
Synopsis: ai-i18n-tools translate-ui [-l <codes>] [--force] [--dry-run] [-j <n>]
Übersetzt nur UI-Strings (strings.json → Locale JSON). Erfordert features.translateUIStrings.
Schlüsseloptionen: -l / --locale, --force, --dry-run, -j / --concurrency
-l / --locale: durch Kommas getrennte Ziellokale (Standard: Konfiguration targetLocales minus sourceLocale). --force: alle Einträge pro Gebietsschema neu übersetzen (bestehende Übersetzungen ignorieren). --dry-run: keine Schreibvorgänge, keine API-Aufrufe. -j parallelisiert Gebietsschemata; innerhalb jedes Gebietsschemas parallelisiert die Konfiguration uiBatchConcurrency (Standard 2) LLM-Batches (Blöcke von 50 Zeichenfolgen, dann Pluralgruppen). Es gibt kein CLI-Flag für uiBatchConcurrency.
sync-ui
Synopsis: ai-i18n-tools sync-ui [-l <codes>] [--force] [--dry-run] [-j <n>]
Extrahieren und dann UI-Strings übersetzen (erfordert features.translateUIStrings). Nur UI – keine Dokumentation, SVG oder json[]. Dieselben Optionen für -l, --force, --dry-run und -j wie bei translate-ui.
proofread-ui
Synopsis: ai-i18n-tools proofread-ui [-l <code>] [--chunk <n>] [--dry-run] [--json] [-j <n>]
Führt zuerst extract aus (erfordert features.translateUIStrings), damit strings.json mit der Quelle übereinstimmt, dann LLM-Überprüfung der UI-Strings der Quell-Locale (Rechtschreibung, Grammatik). Terminologiehinweise stammen nur aus der glossary.userGlossary-CSV-Datei (gleicher Umfang wie translate-ui – nicht strings.json / uiGlossary, sodass schlechte Kopien nicht als Glossar verstärkt werden). Verwendet den aktiven LLM-Anbieter (dessen API-Schlüssel-Umgebungsvariable).
Beendet mit 1 bei Fehlern (fehlendes Feature-Flag, Extraktionsfehler, fehlender/ungültiger Katalog, fehlender API-Schlüssel oder wenn alle Batches fehlschlagen); beendet mit 0, wenn die Ausführung erfolgreich abgeschlossen wird (Ergebnisse sind informativ). Schreibt proofread-ui-results_<timestamp>.log unter cacheDir als menschenlesbaren Bericht (Zusammenfassung, Probleme, nicht überprüfte Zeilen und OK-Zeilen für jeden String); das Terminal gibt nur die Zählwerte der Zusammenfassung und Probleme aus (keine [ok]-Zeilen pro String). Wenn ein Batch fehlschlägt oder eine Modellantwort kürzer als der Batch ist und keinen verwendbaren index für jeden Slot enthält, werden die entsprechenden Strings als nicht überprüft gezählt. Die zugehörigen Probleme werden verworfen, damit ein zu kurzes Array nicht auf die falschen Strings angewendet wird. Gibt den Dateinamen des Protokolls in der letzten Zeile aus. Mit --json wird die menschenlesbare Ausgabe an stderr geleitet. Links verwenden path:line, wie die Link-Schaltfläche für Strings in der Dashboard-UI.
Schlüsseloptionen: -l / --locale, --chunk (Standard 50), --dry-run, --json, -j / --concurrency
export-ui-xliff
Synopsis: ai-i18n-tools export-ui-xliff [-l <codes>] [-o <dir>] [--untranslated-only] [--dry-run]
Exportiert strings.json nach XLIFF 2.0 (eine .xliff pro Ziellokale). Nur lesend; keine API.
Schlüsseloptionen: -l / --locale, -o / --output-dir, --untranslated-only, --dry-run
-o / --output-dir: Ausgabeverzeichnis (Standard: derselbe Ordner wie der Katalog). --untranslated-only: nur Einheiten, denen eine Übersetzung für diese Lokale fehlt.