CLI — はじめに
version
概要: ai-i18n-tools version
CLIのバージョンとビルドタイムスタンプを表示します(ルートプログラムの-V / --versionと同じ情報です)。
upgrade
概要: ai-i18n-tools upgrade [--yes]
実行中のインストールを最新の公開バージョンにアップグレードします。このコマンドは、インストール済みのバージョンと新しいバージョンを表示し、yを待ちます。--yesは、標準入力がターミナルでない場合でも、プロンプトに応答します。それ以外の回答は、インストールを変更しません。--yesなしの非対話型標準入力は、エラーで終了し、何も変更しません。インストールが既に最新であるか、公開バージョンよりも新しい場合、コマンドはその旨を表示し、プロンプトは表示されません。
Node.jsのインストールは、npmレジストリからlatestディストタグを読み取ります。プロジェクトの依存関係はpackage.jsonで更新され(既存の^、~、または厳密な演算子は保持されます)、packageManagerフィールドまたはロックファイルから選択されたnpm、pnpm、yarn、またはbunでインストールされます。グローバルなNode.jsのインストールは、そのパッケージマネージャーのグローバルインストールを実行し、現在のディレクトリのpackage.jsonを編集しません。workspace:、file:、link:、およびgit指定子は変更されず、コマンドは停止します。このリポジトリのソースチェックアウトは拒否されます。
スタンドアロン実行可能ファイルは、最新のGitHubリリースを読み取り、現在のオペレーティングシステムとアーキテクチャ用のgzipアーカイブをダウンロードし、SHA256SUMS.txtをチェックして、実行中のファイルを置き換えます。公開されているアーカイブは、Linux x64、Linux arm64、macOS arm64、macOS x64、およびWindows x64です。
ai-i18n-tools upgrade
ai-i18n-tools upgrade --yesinit
概要: ai-i18n-tools init -P <provider> [-t <template>] [-o <path>] [--with-readme] [--with-translate-ignore]
初期設定ファイルを記述します(provider / providers、concurrency、uiBatchConcurrency、batchConcurrency、batchSize、maxBatchChars、docs[].addFrontmatter を含みます)。LLM を呼び出す翻訳コマンドでは、環境変数または .env にアクティブなプロバイダーの API キーが必要です(Ollama を除く)— プロバイダーと API キー を参照してください。
主なオプション: -P / --provider (必須)、-t / --template、-o / --output、--with-readme、--with-translate-ignore
-P / --provider は必須です。これは、どの組み込みプリセットをスキャフォールドするかを選択します。次のいずれかである必要があります: openrouter、openai、anthropic、gemini、deepseek、cerebras、groq、mistral、xai、nvidia、alibaba、apikeyfan、cheaperinference、ollama。
テンプレート (-t):
| 値 | スキャフォールド |
|---|---|
ui-markdown | UI 文字列と README (フラット出力、言語リスト) |
ui-docusaurus | Docusaurus UI + ドキュメント |
ui-starlight | Starlight ドキュメント |
ui-vitepress | VitePress ドキュメント (docsOutput.style: "vitepress") およびテーマ文字列用 vitepressThemeCatalog |
ui-nextra | Nextra ドキュメント (docsOutput.style: "nextra") およびテーマ辞書用 nextraDictionaryPath (サイドバー _meta.ts は自動的に収集されます) |
ui-fumadocs | Fumadocs ドキュメント (docsOutput.style: "fumadocs") およびUIオーバーライド用 fumadocsUiCatalog (サイドバー meta.json は自動的に収集されます) |
ui-astro-website | Astro ウェブサイトUI文字列 |
ui-plain-html | プレーンHTMLカタログ (data-i18n*マーカー、フラットロケールJSON) |
docs-plain-html | プレーンHTMLドキュメント (ロケールごとに1ファイル、言語リスト、hreflang) |
docs-markdown | Markdown ドキュメント: README と .md ファイル、フラット出力、言語リスト |
ui-json-bundles | JSON (json[] のみ) |
ui-python | Python UI 文字列、ソース言語の文字列をキーとするフラットな JSON、および i18n.py |
ui-python-gettext | フラットな JSON と GNU .po / .mo を使用した Python UI 文字列、および i18n.py |
ui-python-django | Django gettext / {% blocktrans %} カタログ(flatOutput: false、ドメイン django、i18n.py なし) |
ui-python-flask | translations/ 配下の Flask / Jinja カタログ(flatOutput: false)および i18n.py |
ui-dotnet | .NET UI文字列、ソース言語文字列をキーとするフラットなJSON、およびI18n.cs |
ui-dotnet-resx | .NET UI文字列を.resxサテライト (flatOutput: false) およびI18nResx.csとして |
--with-readme は README.md ドキュメント ブロック (outputDir translated-docs、docsOutput.style "flat"、languageListBlock) を追加し、features.translateDocs を true に設定します。ドキュメント ブロックに README.md がすでにリストされている場合 (ui-markdown と docs-markdown の場合がこれに該当します)、何も行いません。設定のみを書き込みます。README.md に貼り付けるマーカー行を出力し、そのファイルが見つからない場合は警告します。ガイド: README と Markdown ドキュメントに i18n を追加する。
ai-i18n-tools init -t docs-markdown -P openrouter
ai-i18n-tools init -t ui-python -P openrouter --with-readme--with-translate-ignore はスターター .translate-ignore を作成します(Python 仮想環境およびキャッシュディレクトリを含みます)。
init は作業ディレクトリに .gitignore を作成するか、または追記します。追加される行は .translation-cache/*、!.translation-cache/cache.db、benchmark-scores.json、.env、.env.local、.env.*.local、*.tmp、および *.backup.* で、それぞれ短いコメントの下に記述されます。既に存在する行はそのままにされ、2回目の実行で重複することはありません。
ui-python、ui-python-gettext、およびui-python-flaskは、そのファイルがない場合にi18n.pyも書き込みます。DjangoプロジェクトはDjango独自のgettextランタイムを保持するため、ui-python-djangoはi18n.pyを書き込みません。ui-dotnetは、そのファイルがない場合にI18n.csを書き込み、.csprojに追加するEmbeddedResource項目を出力します。ui-dotnet-resxは代わりにI18nResx.csを書き込み、ui.resxをResources/SharedResource.<culture>.resxに向けます。--namespaceはC#の名前空間を上書きします。ガイド: .NETアプリケーションおよび.NET ResourceManagerアプリにi18nを追加する。
migrate-python-i18n は、安全でない事前評価済み呼び出し (_(f"...")、_("..." % expr)、_("...".format(...))) を、ルックアップ・ビフォー・フォーマット呼び出しに書き換えます。デフォルトはドライランです。ファイルを編集するには --write を渡し、レビューノートについては migrate-python-i18n-report.md をお読みください。複雑な式は、それが安定している場合にその式から命名されます (start.isoformat() は {start} に、len(rows) は {rows_count} になります)。残された {value_1} は、名前を変更できるように報告されます。生成された i18n.py ファイルはスキップされます。クリーンなレポートは、アンラップされた f-文字列がカバーされたことを意味しません。
migrate-dotnet-i18n は、T() 内の T($"...")、連結、および string.Format に対して同様の処理を行います。--wrap は、マークされていないXAMLラベルと信頼度の高いC#シンクもマークします。--write がないと、これは監査になります。レポートは migrate-dotnet-i18n-report.md です。生成された I18n.cs および I18nResx.cs はスキップされます。ガイド: .NETアプリケーション。
doctor
概要: ai-i18n-tools doctor [--local] [--strict] [--json] [--fix-gitignore]
プロジェクトが翻訳準備完了であるかを確認します。レポートには、設定構文とスキーマ、ビジネスルール、インストールされているバージョン、ソースパスと出力パス、UIカタログファイル、それらのカタログ内のプレースホルダーの不一致、キャッシュ統計、設定済みのプロバイダー、設定されているサポート対象の環境変数、およびモデルIDが含まれます。プレースホルダーの名前が変更された、削除された、または書き換えられたカタログは警告として扱われ、その一例が示されます。プロバイダーセクションには、設定ファイルで指定されたプロバイダーのみがリストされます(レガシーなトップレベルのopenrouterブロックを含む)。ファイルにプロバイダーが指定されていない場合にのみ、組み込みのOpenRouterデフォルトがリストされます。
デフォルトでは、doctor は設定済みのモデルIDをアクティブなプロバイダーのカタログと照合し、インストールされているバージョンを最新のGitHubリリースと比較します。--local は両方のネットワーク呼び出しをスキップします。新しいリリース、またはGitHubリクエストの失敗は警告となります。モデルIDが見つからないか期限切れの場合、コマンドは失敗します。いずれかのチェックで警告が出た場合、--strict はエラーで終了します。
APIキーの値は決して出力されません。設定済み変数は、Configured variables: NAME, ...としてアルファベット順に一覧表示されます。APIキーではない変数については、その値も表示されます。
入力パスが見つからない場合は失敗します。出力ディレクトリが見つからない場合は注意が必要です。最初の翻訳実行時に作成されるためです。doctor は、設定を書き換えたり、ディレクトリを作成したり、ソーステキストをモデルに送信したりしません。--fix-gitignore は、不足している .gitignore 行を追記し、他のすべてのファイルはそのままにします。
設定の隣にある .gitignore に必須のパターンが不足している場合、doctor は警告を発します。その警告は、ai-i18n-tools doctor --fix-gitignore を実行するよう指示します。.gitignore が既に存在する場合、空白行、コメント # ai-i18n-tools doctor fix、および不足している行のみが追記されます。既に存在する行は重複させません。不足しているファイルは、init が書き込むのと同じブロックで作成されます。2つのキャッシュパターンは設定された cacheDir に従うため、.i18n-cache はデフォルトの .translation-cache 行ではなく、.i18n-cache/* と !.i18n-cache/cache.db を必要とします。その他のパターンは benchmark-scores.json、.env、.env.local、.env.*.local、*.tmp、および *.backup.* です。.i18n-cache/ のようにキャッシュディレクトリ自体を無視する行も警告です。Git は無視されたディレクトリ内の cache.db を追跡しないためです。--fix-gitignore はその行を削除しません。この警告は、--strict を使用した場合にのみコマンドを失敗させます。
主なオプション: --local、--strict、--json、--fix-gitignore
ai-i18n-tools doctor
ai-i18n-tools doctor --local
ai-i18n-tools doctor --fix-gitignorehelp
概要: ai-i18n-tools help [command]
サブコマンドのヘルプを表示します(ai-i18n-tools <command> --helpと同じ出力です)。