ai-i18n-tools

ai-i18n-tools任意のLLMでアプリとドキュメントを翻訳

1つの設定ファイル、3つの翻訳モード、そして選択したプロバイダー（OpenAI、Anthropic、Gemini、OpenRouter、Ollama、またはOpenAI互換の任意のAPI）に対応。コードベースを書き換えることなく、プロジェクトやロケールごとにモデルを切り替えられます。

🌐

UI文字列

JS、TS、Astroから t() 呼び出しを抽出し、i18nextや静的SSGルックアップ向けにロケールごとのフラットなJSONを生成します。

📄

ドキュメント

VitePress、Starlight、Docusaurus、Nextra、Fumadocs、および通常の静的サイト向けにMarkdown、MDX、Astroページを翻訳します。

📦

JSONバンドル

ソースの t() 呼び出し以外にUIコピーが存在する場合（テーマラベル、カタログ、アプリの上書きなど）に使用する、ネストされたロケールJSON。

🔄

スマートキャッシュ

すべてのパイプラインで共有されるSQLiteキャッシュ。再実行時に新規または変更されたセグメントのみがモデルに送信されます。

🔌

プロバイダー非依存

主要なLLM APIの組み込みプリセットに加え、カスタムのOpenAI互換エンドポイントに対応。-P でアクティブなプロバイダーを上書きできます。

⚡

1つの同期コマンド

1つの設定から、extract、translate-ui、translate-svg、translate-docs、translate-jsonを正しい順序で実行します。

クイックインストール

公開されているパッケージはESM専用です。Node.js >=22.16.0 が必要です。

bash

pnpm add ai-i18n-tools
# Set API key for your active provider — see preset table (default init: openrouter)
export OPENROUTER_API_KEY=sk-or-v1-your-key-here
ai-i18n-tools init [-P <provider>]
ai-i18n-tools sync

どのパイプラインを使用すべきですか？

コンテンツ	コマンド
ソースコードで`t()`を使用	UI文字列 — `extract` / `translate-ui`
ローカライズされたページやドキュメントサイト	ドキュメント — `translate-docs`
スタンドアロンのネストされたJSONロケールファイル	JSON — `translate-json`

コンテンツ

コマンド

ソースコードでt()を使用

UI文字列 — extract / translate-ui

ローカライズされたページやドキュメントサイト

ドキュメント — translate-docs

スタンドアロンのネストされたJSONロケールファイル

JSON — translate-json

SVGイラストはdocs[].contentPathsではなく、別のtranslate-svgパスを使用します。完全な比較についてはai-i18n-toolsとは？を参照してください。

ドキュメントを探索する

ガイド — 翻訳モード、インストール、クイックスタート、フレームワークの統合

統合 — VitePress、Nextra、Fumadocs、Docusaurus、および Astro

プロバイダーとモデル — プリセット、フォールバックチェーン、および -P のオーバーライド

CLIリファレンス — すべてのコマンド、フラグ、ワークフロー

設定 — 完全な ai-i18n-tools.config.json スキーマ

例 — npx degit を使用した9つの実行可能なデモプロジェクト

アーキテクチャ — 内部構造、プログラマティックAPI、拡張ポイント

パッケージを自分のプロジェクトに組み込む場合は、AI Agent Context から始めてください。リポジトリの README は短い GitHub/npm ランディングページであり、詳細についてはここへリンクしています。