CLI — ワークフローとレポート
sync
概要: ai-i18n-tools sync [options]
抽出(有効な場合)、次にUI翻訳、次にfeatures.translateSVGとconfig.svgが設定されている場合のtranslate-svg、次にドキュメント翻訳、次にfeatures.translateJsonとjson[]が設定されている場合のtranslate-json — ただし--no-ui、--no-svg、--no-docs、または--no-jsonでスキップされた場合を除きます。
主なオプション: -l, -p / -f, --dry-run, -j, -b, --force, --force-update, --check-cache, --recheck-glossary-warnings, --no-ui, --no-svg, --no-docs, --no-json
--forceは、ドキュメント、JSON、SVGのセグメントキャッシュとファイル追跡をクリアします。これはUI翻訳には転送されません。strings.jsonを再翻訳するには、translate-ui --forceまたはsync-ui --forceを使用してください。--force-updateはドキュメント、JSON、SVG(UIは除く)に適用されます。--no-ui、--no-svg、--no-docs、--no-jsonは、1回の実行でその手順をスキップします。--fileは翻訳するファイルを制限し、ドキュメントブロック内のすべてのマークダウンファイルを使用してフラットな兄弟リンクを書き換えます。--check-cacheはドキュメント、JSON、SVGに転送されます。ファイル追跡がスキップする場合でも、強制ネイティブスクリプトが設定されているロケールに対してキャッシュされたセグメントを再検証します。ドキュメントフェーズでは、--emphasis-placeholdersも転送されます(translate-docsと同じ意味です)。グローバルな--debug-failedは、チェーン内のすべてのモデルが失敗した場合だけでなく、破棄された各モデルの試行(SVG/ドキュメントスクリプトのフォールバックを含む)について、cacheDirの下にFAILED-TRANSLATIONログを書き込みます。--prompt-formatはsyncフラグではありません。ドキュメントとJSONの手順は、組み込みのデフォルト(json-array)を使用します。
status
概要: ai-i18n-tools status [--max-columns <n>]
features.translateUIStrings がオンの場合、ロケールごとの UI カバレッジ(Translated / Missing / Placeholder issues / Total)を出力します。Placeholder issues は、保存された翻訳がプレースホルダーの名前を変更したり、削除したり、新しく作成したり、ターゲットを変更したりする行をカウントします。次に、ファイル × ロケールごとの Markdown 翻訳ステータスを出力します(--locale フィルターなし。ロケールは設定から取得されます)。features.translateJson がオンで json[] が設定されている場合、ブロックごとの JSON バンドルステータスも出力します。大規模なロケールリストは、ターミナルで表示される行が狭く保たれるように、最大 n 個のロケール列(デフォルトは 9)を持つ繰り返しテーブルに分割されます。
主なオプション: --max-columns
statistics
概要: ai-i18n-tools statistics [--max-columns <n>]
ドキュメントキャッシュおよびstrings.jsonの統計(翻訳ダッシュボード → 統計と同じ集計)を出力します。--max-columns: モデル×ロケールテーブルあたりの最大ロケール列数(デフォルト6)。
主なオプション: --max-columns
関連項目: ダッシュボード統計
usage
概要: ai-i18n-tools usage [--since <when>] [--provider <name>] [--model <id>] [--operation <name>] [-l <code>] [--outcome accepted|discarded] [--clear] [--older-than <when>] [--dry-run]
記録されたモデルのAPI呼び出し統計(呼び出し回数、トークン数、および単一のUSDコスト)を出力します。コストは、存在する場合はプロバイダーのusage.cost(0を含む)が使用され、それ以外の場合はそのモデルのproviders.<name>.modelPricing、それ以外の場合はプロバイダー全体のproviders.<name>.pricingデフォルト、それ以外の場合はそのモデルIDに対するmodels.devの入出力リスト価格が使用されます。報告済みのコストおよび明示的な設定レートは置き換えられません。不明なコストは—のままとなり、$0.00になることはありません。新しい呼び出しは金額を保存します。トークン数はあるが保存されたコストがない古い行は、レポート実行時に推定されます。集計は「Translation Dashboard → Usage & costs」と同じです。UTCで7暦日以上経過した詳細行は月次のapi_totalsにまとめられ、レポートは両方のテーブルを結合します。--sinceは、YYYY-MM-DD、期間(30m、1h、6h、12h、24h、7d、30d)、または暦月の期間(1mo、2mo、3mo)を受け付けます。--clearは詳細行と月次合計を削除します(--older-thanは1mo、2mo、3mo、6mo、1y、またはallです。--dry-runは削除せずに件数を報告します)。
主なオプション: --since, --provider, --model, --operation, -l / --locale, --outcome, --clear, --older-than, --dry-run
関連項目: ダッシュボードの使用量とコスト