安装
环境要求
- Node.js 20.11+ (原生 ESM)
- 翻译 API 密钥（见下文）
安装
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev i18n-rosetta
npx i18n-rosetta sync
pnpm add -D i18n-rosetta
yarn add --dev i18n-rosetta
获取 API 密钥
Rosetta 需要一个翻译后端。请选择一个：
| 提供商 | 环境变量 | 适用场景 |
|---|---|---|
| OpenRouter（推荐） | OPENROUTER_API_KEY | 内容密集的项目、Markdown、200+ 模型 |
| Gemini（免费额度） | GEMINI_API_KEY | 零成本起步、质量良好 |
| OpenAI | OPENAI_API_KEY | 直接访问 GPT-4o |
| Anthropic | ANTHROPIC_API_KEY | 直接访问 Claude、文本细节处理好 |
| DeepL | DEEPL_API_KEY | 欧洲语言、内置正式度控制 |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | 大量键值对、130+ 语言 |
| Microsoft Translator | MICROSOFT_TRANSLATOR_API_KEY | Azure、100+ 语言 |
| LibreTranslate | LIBRETRANSLATE_API_URL | 自托管、隐私优先 |
- OpenRouter (recommended)
- Google Translate
OpenRouter 为 200 多种 LLM 模型提供统一的 API。提供免费额度。
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
或者添加到 .env.local 中：
OPENROUTER_API_KEY=sk-or-v1-your-key-here
适用场景：内容密集的项目、Markdown 翻译，以及需要内容感知保护（代码块、短代码、插值变量）的项目。
export GOOGLE_TRANSLATE_API_KEY=...
适用场景：大量键值对字符串（130+ 语言）。不推荐用于 Markdown 内容——Google Translate 无法识别代码块、短代码或插值变量。
:::tip 智能检测
如果仅设置了 GOOGLE_TRANSLATE_API_KEY（没有 OpenRouter 密钥），rosetta 会自动切换到 Google Translate。无需更改配置。
:::
验证安装
npx i18n-rosetta --help
你应该能看到可用命令的列表。你现在可以进入快速开始了。