ai-i18n-tools

Appearance

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

t()文字列を抽出し、Markdown、MDX、JSONバンドル、SVGラベルを翻訳します。これらすべてを単一の設定で、OpenAI、Anthropic、Gemini、OpenRouter、Ollama、または任意のOpenAI互換APIを使用して実行できます。コードベースを書き換えることなく、プロジェクトごとまたはロケールごとにモデルを切り替えられます。

はじめる
GitHubで見る
npm パッケージ
ai-i18n-tools ロゴ
  • 🌐

    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を正しい順序で実行します。

npm version npm downloads Node.js License: MIT CI

クイックインストール ​

公開されているパッケージは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

単体のCLIコマンドの設定（クローンしたモノレポでの開発を含む）についてはインストールを、スキャフォールドテンプレートについてはクイックスタートを参照してください。

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

コンテンツコマンド
ソースコードで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を使用した12の実行可能なデモプロジェクト
  • アーキテクチャ — 内部構造、プログラムAPI、および拡張ポイント

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



免責事項

製品名およびアイコンはそれぞれの所有者に帰属し、識別目的でのみ使用されています。本ソフトウェアは、これらのブランドとの提携や推奨を受けているものではありません。

英語（英国）を除くすべてのインターフェースおよびドキュメントの言語は、本パッケージ（ai-i18n-tools）を使用してAIにより翻訳されています。そのため、表現が不正確であったり、誤りを含んでいる可能性があります。


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

Copyright © Waldemar Scudeller Jr.