ai-i18n-tools

Appearance

翻訳ダッシュボード ​

翻訳ダッシュボードは、プロジェクトの翻訳データを検査および編集するためのローカルWeb UIです。次の3つのストアから読み取ります。

  • SQLiteキャッシュ (cacheDir) — ドキュメントセグメントの翻訳、失敗レコード、Markdownの問題スキャン、課金対象API呼び出しの使用量
  • strings.json — UI文字列カタログ（通常文字列と複数形グループ）
  • ユーザーグロサリーCSV (glossary.userGlossary) — translate-uiおよびproofread-uiの用語ヒント

翻訳実行後にこれを使用して、SQLiteやJSONを手動で掘り下げることなく、問題を見つけたり、不正な出力を上書きしたり、キャッシュのカバレッジを確認したりできます。

ダッシュボードを起動する ​

bash
ai-i18n-tools dashboard
# Optional: choose port, do not auto-open browser
# ai-i18n-tools dashboard -p 8765 --no-open

デフォルトのリッスンポートは8675です。そのポートが利用できない場合、サーバーは次のポートを試行し（最大1000回まで）、選択したポートをログに記録します。dashは同等のエイリアスです。非推奨のエイリアスeditorは引き続き機能しますが、警告を出力します — dashboardまたはdashを優先してください。

ダッシュボードUIはCLIと同じロケール解決を使用します: -L / --ui-lang → AI_I18N_LANG → config uiLanguage → OSロケール。ツールUI言語を参照してください。

フィルターとキャッシュされたセグメント行を含むドキュメントタブを表示している翻訳ダッシュボード

どのタブを使用すればよいですか？ ​

実行したいことタブガイド
翻訳に失敗したドキュメントセグメントを修正する失敗失敗
翻訳する前にソースMarkdownを修正するMarkdownの問題Markdownの問題
キャッシュされたドキュメント翻訳を上書きするドキュメントドキュメントキャッシュ
UIラベルを修正するUI文字列UI文字列と複数形
複数形を修正する (one、other、…)UI複数形UI文字列と複数形
UI翻訳の用語をロックする用語集用語集
キャッシュのカバレッジとモデルの使用状況を確認する統計統計
API呼び出しトークンとコストを参照使用量とコスト使用量とコスト

編集後 ​

編集したもの…次に実行する…避けるべきこと…
ドキュメントキャッシュ行sync --force-update または translate-docs --force-update—
UI文字列または複数形プレーンな sync または translate-ui--force (user-edited行を上書きします)
用語集行次の translate-ui または proofread-ui—

ドキュメント（SQLiteキャッシュ） — キャッシュ内の手動編集にはモデル user-edited のタグが付けられます。ロケールの書記体系チェックに失敗した編集（例: hi のローマ字表記のヒンディー語）は警告を表示しますが、確認するとテキストがそのまま保存されます。変更されていないソースに対して translate-docs または sync を再実行すると、キャッシュされた翻訳が再利用されます（LLM呼び出しは発生しません）。sync --force-update または translate-docs --force-update を実行して、キャッシュからディスク上のMarkdownを更新します。--check-cache を使用すると、すべてのファイルを書き換えることなく（間違った書記体系で確定された編集を含む）、ネイティブスクリプトのロケールを再検証できます。--force は、キャッシュをバイパスしてLLMから再翻訳したい場合（手動修正を上書きする場合）にのみ使用してください。

UI 文字列 (strings.json) — 手動編集は models[locale] 内で user-edited でタグ付けされます。translate-ui または sync を再実行すると、すでに翻訳があるエントリはスキップされます。手動修正を再翻訳して上書きするには、UI コマンドで --force を使用します。

ヒント ​

  • ログリンクボタン (表の行の 🔗) は、ai-i18n-tools dashboard が実行されているターミナルにファイル:行のヒントを出力します。これは、ブラウザからエディタにジャンプするのに便利です。VS Code 派生 IDE (Cursor、Antigravity など) を使用している場合、ターミナルウィンドウのファイル:行リンクを CTRL クリックすると、指定された行でファイルを開くことができます。
  • 閉じる (タブバーの右上) は、ダッシュボードサーバーを正常にシャットダウンします。
  • ブラウザタブが開いている間にサーバーが停止すると、オーバーレイが表示されます。再接続するには ai-i18n-tools dashboard を再起動するか、ダッシュボードでの作業が終了した場合はウィンドウを閉じます。

MITライセンスの下で公開されています。

Copyright © Waldemar Scudeller Jr.