CLI – UI-Zeichenfolgen
extract
Synopsis: ai-i18n-tools extract
Aktualisiert strings.json aus t("…")- / i18n.t("…")-Literalen, der optionalen package.json-Beschreibung und optionalen gebündelten Master-englishName-Einträgen, wenn includeUiLanguageEnglishNames aktiviert ist (siehe ui.uiExtractor; liest languagesManifestPath nicht). Regeneriert außerdem ui-languages.json jedes Blocks. Wenn .html / .htm in ui.uiExtractor.extensions aufgeführt sind, werden auch data-i18n- / data-i18n-title- / data-i18n-placeholder-Marker-Strings aus dem HTML erfasst. Durchläuft jeden ui-Block, der sourceRoots enthält. --ui-block beschränkt die Ausführung auf einen Block (Index, Beschreibung oder stringsJson-Pfad). 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>]
Intlayer *.content.ts-Wörterbücher in strings.json und flache Locale-Dateien importieren und einfache useIntlayer / getIntlayer-Aufrufstellen zu t('source string') umschreiben. Der String ist in sourceLocale geschrieben, was jede Sprache sein kann. Standardmäßig im Trockenlauf (der Bericht wird trotzdem geschrieben). --write initialisiert 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
translate-intlayer
Zusammenfassung: ai-i18n-tools translate-intlayer [paths...] [-l <codes>] [--ui-block <selector>] [--dry-run] [-j <n>]
Fehlende und veraltete Locale-Blätter innerhalb von Intlayer *.content.ts-Wörterbüchern direkt übersetzen, wobei die Wörterbücher die Quelle der Wahrheit bleiben. Im Gegensatz zu migrate-intlayer verschiebt dies die Anwendung nicht von Intlayer weg; es füllt nur die t({ … })-Blätter. Verwenden Sie es, wenn Sie Intlayer zur Laufzeit beibehalten und ai-i18n-tools als Übersetzungs-Engine verwenden möchten.
Es extrahiert jedes t({ … })-Blatt, befüllt den strings.json des gewählten UI-Blocks mit dem Quelltext, führt dieselbe Engine wie translate-ui aus (Anbieterauswahl, Glossar, Übersetzungskontext und Modell-Fallback) und schreibt dann die neuen lokalisierungsspezifischen Zeichenfolgen zurück in jedes t({ … })-Objekt. Die Änderungen sind präzise: Nur die fehlenden oder veralteten Locale-Zeilen werden geändert, sodass Ihre Formatierung und Kommentare erhalten bleiben. Intlayer {token}-Platzhalter durchlaufen einen Roundtrip zu {{token}} zur Übersetzung und zurück.
Ein Blatt+Locale wird übersetzt, wenn das Locale im Blatt fehlt (fehlend), oder wenn sich der Quell-Locale-Text seit dem letzten Lauf für dieses Locale geändert hat (veraltet). Veraltetheit wird in cacheDir verfolgt, sodass das Bearbeiten dieses Quell-Strings dieses eine Blatt beim nächsten Lauf neu übersetzt. Die Quellsprache ist sourceLocale und kann jede Sprache sein. --dry-run meldet die fehlenden/veralteten Zählungen, ohne ein LLM aufzurufen oder etwas zu schreiben. Erfordert features.translateUIStrings und das stringsJson des UI-Blocks (wie translate-ui).
Wichtige Optionen: -l / --locale, --ui-block, --dry-run, -j / --concurrency
[paths...]: Dateien/Verzeichnisse/Globs zum Scannen (Standard: der sourceRoots des Blocks). -l / --locale: kommagetrennte Ziellokale zum Befüllen (Standard: die konfigurierten targetLocales des Blocks). --ui-block: nullbasierter Index, Beschreibung oder stringsJson-Pfad (Standard: Block 0). -j parallelisiert Lokale.
Siehe auch: migrate-intlayer, Migration von Intlayer
mark-html
Synopsis: ai-i18n-tools mark-html [paths...] [--write]
Fügt reine data-i18n- / data-i18n-title- / data-i18n-placeholder-Marker in HTML ein, sodass der Quelltext nur einmal geschrieben wird (direkt auf dem Element selbst). Scannt die angegebenen Dateien/Verzeichnisse/Globs (Standard: .html / .htm unter sourceRoots jedes Blocks). Standardmäßig ein Trockenlauf (meldet die Anzahl der hinzugefügten Einträge pro Datei und alle Elemente mit gemischtem Inhalt, die ein manuelles <span data-i18n> erfordern); --write wendet die Änderungen an. Idempotent, respektiert data-i18n-ignore (überspringt das Element und seinen Unterbaum), fasst niemals codeähnliche Elemente (code, pre, kbd, samp, var) oder leeren/rein numerischen Text an und gibt niemals einen Marker mit Wert 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: kommagetrennte Ziellokale (Standard: Konfiguration targetLocales abzüglich sourceLocale). --force: alle Einträge pro Lokale neu übersetzen (bestehende Übersetzungen ignorieren). --dry-run: keine Schreibvorgänge, keine API-Aufrufe. -j parallelisiert Lokale; innerhalb jedes Lokals parallelisiert Konfiguration uiBatchConcurrency (Standard 2) LLM-Batches (Blöcke von 50 Zeichenketten, dann Pluralgruppen). Es gibt kein CLI-Flag für uiBatchConcurrency. Jeder erfolgreiche Batch wird in strings.json und die flache Lokale-Datei geschrieben, bevor der nächste Batch beginnt. sync-ui und der UI-Schritt von sync verwenden denselben Schreibvorgang.
Eine gespeicherte Übersetzung, deren Platzhalter nicht mit ihrer Quelle übereinstimmen, wird erneut übersetzt. Die Prüfung umfasst einen umbenannten Namen ({schedule} wird zu {cronograma}), ein gelöschtes oder erfundenes Token und eine Änderung der Formatspezifikation ({price:,.2f} wird zu {price}). Die Anzahl wird vor dem Batch ausgegeben, einschließlich auf --dry-run. Eine Zeile, deren Modell user-edited ist, bleibt bestehen und es wird nur davor gewarnt. Eine Zeichenfolge, die nur aus Platzhaltern und Satzzeichen besteht, wie z.B. {state} · {title}, wird kopiert und nicht an ein Modell gesendet. Ein Batch, der einen Platzhalter umbenennt, wird abgelehnt, und das nächste Modell in der Kette wird mit angehängtem Fehler versucht. Das Dashboard kennzeichnet dieselben Zeilen und fragt vor dem Speichern einer Übersetzung, die einen Platzhalter beschädigt.
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 jeder ausgewählte Katalog der Quelle entspricht, führt dann eine LLM-Überprüfung von UI-Zeichenketten der Quelllokale durch (Rechtschreibung, Grammatik). --ui-block begrenzt Extraktion und Überprüfung auf einen Block. Terminologiehinweise stammen nur aus glossary.userGlossary CSV (gleicher Umfang wie translate-ui – UI-Kataloge werden nicht zurückgeführt, sodass schlechte Texte 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.