ai-i18n-tools

🌐

UI 字串

從 JS、TS 與 Astro 中提取 t() 呼叫。為 i18next 或靜態 SSG 查詢產生各語系的扁平化 JSON。

📄

文件

翻譯適用於 VitePress、Starlight、Docusaurus、Nextra、Fumadocs 與純靜態網站的 Markdown、MDX 與 Astro 頁面。

📦

JSON 包

當 UI 文案位於原始碼 t() 呼叫之外時的巢狀語系 JSON — 主題標籤、目錄與應用程式覆寫。

🔄

智慧快取

跨每個管線共享的 SQLite 快取。重新執行時僅將新增或變更的段落傳送至模型。

🔌

供應商中立

內建主流 LLM API 的預設集，並支援自訂相容於 OpenAI 的端點。使用 -P 覆寫作用中的供應商。

⚡

一個同步指令

從單一設定檔以正確順序執行 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 插圖使用獨立的 translate-svg 路徑 — 而非 docs[].contentPaths。如需完整比較，請參閱什麼是 ai-i18n-tools？。

探索文件

指南 — 翻譯模式、安裝、快速入門與框架整合

整合 — VitePress、Nextra、Fumadocs、Docusaurus 與 Astro

供應商與模型 — 預設、後備鏈與 -P 覆寫

CLI 參考 — 每個指令、旗標與工作流程

設定 — 完整 ai-i18n-tools.config.json 結構描述

範例 — 九個可執行的示範專案，附 npx degit

架構 — 內部原理、程式化 API 與擴充點

要將套件整合到您自己的專案中嗎？請從 AI Agent Context 開始。repository README 是一個簡短的 GitHub/npm 首頁，它會連結至此以取得詳細資訊。

ai-i18n-tools使用任何 LLM 翻譯應用程式與文件