ai-i18n-tools

ai-i18n-toolsApps & Docs mit jedem LLM übersetzen

Eine Konfigurationsdatei, drei Übersetzungsmodi und der von Ihnen gewählte Anbieter – OpenAI, Anthropic, Gemini, OpenRouter, Ollama oder jede OpenAI-kompatible API. Wechseln Sie Modelle pro Projekt oder pro Gebietsschema, ohne Ihren Code neu schreiben zu müssen.

🌐

UI-Strings

Extrahieren Sie t()-Aufrufe aus JS, TS und Astro. Generieren Sie flaches JSON pro Gebietsschema für i18next oder statische SSG-Suche.

📄

Dokumente

Übersetzen Sie Markdown-, MDX- und Astro-Seiten für VitePress, Starlight, Docusaurus, Nextra, Fumadocs und einfache statische Websites.

📦

JSON-Bundles

Verschachteltes JSON für Gebietsschemas, wenn UI-Texte außerhalb von Quell-t()-Aufrufen liegen – Themenbeschriftungen, Kataloge und App-Überschreibungen.

🔄

Intelligentes Caching

Gemeinsamer SQLite-Cache über jede Pipeline hinweg. Nur neue oder geänderte Segmente werden bei erneuten Ausführungen an das Modell gesendet.

🔌

Anbieterunabhängig

Integrierte Voreinstellungen für wichtige LLM-APIs sowie benutzerdefinierte OpenAI-kompatible Endpunkte. Überschreiben Sie den aktiven Anbieter mit -P.

⚡

Ein Synchronisierungsbefehl

Führen Sie extract, translate-ui, translate-svg, translate-docs und translate-json in der richtigen Reihenfolge aus einer einzigen Konfiguration aus.

Schnellinstallation

Das veröffentlichte Paket ist nur ESM. Node.js >=22.16.0 ist erforderlich.

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

Welche Pipeline soll ich verwenden?

Ihr Inhalt	Befehl
Quellcode verwendet `t()`	UI-Strings — `extract` / `translate-ui`
Lokalisierte Seiten oder Dokumentationsseiten	Dokumente — `translate-docs`
Eigenständige verschachtelte JSON-Gebietsschemadateien	JSON — `translate-json`

Ihr Inhalt

Befehl

Quellcode verwendet t()

UI-Strings — extract / translate-ui

Lokalisierte Seiten oder Dokumentationsseiten

Dokumente — translate-docs

Eigenständige verschachtelte JSON-Gebietsschemadateien

JSON — translate-json

SVG-Illustrationen verwenden einen separaten translate-svg-Pfad – nicht docs[].contentPaths. Einen vollständigen Vergleich finden Sie unter Was ist ai-i18n-tools?.

Dokumentation erkunden

Leitfaden – Übersetzungsmodi, Installation, Schnellstart und Framework-Integrationen

Integrationen – VitePress, Nextra, Fumadocs, Docusaurus und Astro

Anbieter und Modelle – Voreinstellungen, Fallback-Ketten und -P-Überschreibungen

CLI-Referenz – jeder Befehl, jedes Flag und jeder Workflow

Konfiguration – vollständiges ai-i18n-tools.config.json-Schema

Beispiele – neun ausführbare Demo-Projekte mit npx degit

Architektur – Interna, programmatische API und Erweiterungspunkte

Möchten Sie das Paket in Ihr eigenes Projekt integrieren? Beginnen Sie mit AI Agent Context. Die Repository-README ist eine kurze GitHub/npm-Landingpage, die für Details hierher verlinkt.