CLI — UI文字列
extract
概要: ai-i18n-tools extract
includeUiLanguageEnglishNamesが有効な場合、t("…") / i18n.t("…")リテラル、オプションのpackage.json説明、およびオプションのバンドルされたマスターenglishNameエントリからstrings.jsonを更新します（ui.uiExtractorを参照、languagesManifestPathは読み取りません）。また、languagesManifestPathでui-languages.jsonを再生成します。.html / .htmがui.uiExtractor.extensionsにリストされている場合、HTMLからdata-i18n / data-i18n-title / data-i18n-placeholderマーカー文字列もキャプチャします。空でないui.sourceRootsが必要です。LLMは呼び出しません。
関連項目: UI文字列の概要, プレーンHTMLアプリ
mark-html
概要: ai-i18n-tools mark-html [paths...] [--write]
ソーステキストが1回（要素自体に）書き込まれるように、裸のdata-i18n / data-i18n-title / data-i18n-placeholderマーカーをHTMLに挿入します。指定されたファイル/ディレクトリ/グロブをスキャンします（デフォルト: ui.sourceRootsの下の.html / .htm）。デフォルトでドライラン（ファイルごとの追加数と、手動の<span data-i18n>が必要な混合コンテンツ要素を報告します）。--writeが変更を適用します。冪等であり、data-i18n-ignoreを尊重し（要素とそのサブツリーをスキップします）、コードのような要素（code, pre, kbd, samp, var）や空のテキスト/数値のみのテキストには決して触れず、値を持つマーカーは発行しません。LLMは呼び出しません。
主なオプション: --write
関連項目: 翻訳用のHTMLのマーキング
generate-ui-languages
概要: ai-i18n-tools generate-ui-languages [--master <path>] [--dry-run]
sourceLocale + targetLocalesとバンドルされたdata/ui-languages-complete.json（または--master）を使用して、ui-languages.jsonをlanguagesManifestPath（デフォルトは{ui.flatOutputDir}/ui-languages.json）に書き込みます。マスターファイルにないロケールに対して警告し、TODOプレースホルダーを出力します。カスタマイズされたlabelまたはenglishNameの値を持つ既存のマニフェストがある場合、それらはマスターカタログのデフォルトに置き換えられます。後で生成されたファイルを確認して調整してください。
主なオプション: --master, --dry-run
translate-ui
概要: ai-i18n-tools translate-ui [-l <codes>] [--force] [--dry-run] [-j <n>]
UI文字列のみを翻訳します（strings.json → ロケールJSON）。features.translateUIStringsが必要です。
主なオプション: -l / --locale, --force, --dry-run, -j / --concurrency
-l / --locale: カンマ区切りのターゲットロケール（デフォルト: 設定targetLocalesからsourceLocaleを引いたもの）。--force: ロケールごとにすべてのエントリを再翻訳します（既存の翻訳を無視します）。--dry-run: 書き込みやAPI呼び出しを行いません。
sync-ui
概要: ai-i18n-tools sync-ui [-l <codes>] [--force] [--dry-run] [-j <n>]
UI文字列を抽出してから翻訳します (features.translateUIStringsが必要)。UIのみ — ドキュメント、SVG、json[]は含みません。translate-uiと同じ-l、--force、--dry-run、-jオプション。
proofread-ui
概要: ai-i18n-tools proofread-ui [-l <code>] [--chunk <n>] [--dry-run] [--json] [-j <n>]
最初にextractを実行し (features.translateUIStringsが必要) 、strings.jsonがソースと一致するようにしてから、ソースロケールのUI文字列 (スペル、文法) のLLMレビューを行います。用語のヒントはglossary.userGlossary CSVからのみ取得されます (translate-uiと同じスコープ — strings.json / uiGlossaryではないため、悪いコピーが用語集として強化されることはありません)。アクティブなLLMプロバイダー (そのAPIキー環境変数) を使用します。
失敗時 (機能フラグの欠落、抽出の失敗、カタログの欠落/無効、APIキーの欠落、またはすべてのバッチが失敗した場合) には1で終了し、実行が正常に完了した場合 (結果は参考情報です) には0で終了します。cacheDirの下にproofread-ui-results_<timestamp>.logを人間が読めるレポート (サマリー、問題、文字列ごとのOK行) として書き込みます。ターミナルにはサマリーのカウントと問題のみを出力します (文字列ごとの[ok]行はありません)。最後の行にログファイル名を出力します。--jsonを使用すると、人間向けの出力はstderrに送られます。リンクはダッシュボードのUI文字列リンクボタンのようにpath:lineを使用します。
主なオプション: -l / --locale, --chunk (デフォルト 50), --dry-run, --json, -j / --concurrency
export-ui-xliff
概要: ai-i18n-tools export-ui-xliff [-l <codes>] [-o <dir>] [--untranslated-only] [--dry-run]
strings.jsonをXLIFF 2.0にエクスポートします (ターゲットロケールごとに1つの.xliff)。読み取り専用、APIはありません。
主なオプション: -l / --locale, -o / --output-dir, --untranslated-only, --dry-run
-o / --output-dir: 出力ディレクトリ (デフォルト: カタログと同じフォルダ)。--untranslated-only: そのロケールの翻訳が欠落しているユニットのみ。