l10n.dev 入门指南

l10n.dev 是一个专为开发者和本地化团队构建的 AI 驱动的本地化平台。它可以在保留翻译键、结构、占位符和复数形式的同时翻译您的 i18n 文件——无论您是通过 AI 代理、终端、CI 流程还是 Web 工作区使用。本页面将引导您完成首次翻译，并展示平台在您完成设置后所能实现的功能。

第 1 步：创建账户

创建您的 API 密钥

Web 工作区之外的所有内容——包括 AI 代理、CLI、GitHub Action、插件和 API——均使用 API 密钥进行身份验证。请在以下页面创建一个：API 密钥 页面并妥善保存：您需要将其粘贴到您的代理配置、CLI 配置或 CI 密钥中。您可以随时撤销并重新颁发密钥。

第 2 步：选择您的本地化方式

使用 l10n.dev 有三种方式。它们共享相同的翻译引擎、字符余额、词汇表和语言指令——因此请选择最适合您当前工作流程的一种，以后也可以混合使用。

AI 本地化代理 (MCP)

将您的 AI 代理连接到我们的 MCP 服务器，即可将其转化为专业的本地化工具。代理无需自行翻译字符串（这会消耗上下文并导致运行结果不一致），而是调用 l10n.dev 作为专用翻译引擎并获取最终文件。这就像您的团队中有一位本地化专家。

• 令牌高效：翻译内容永远不会经过您代理的上下文窗口，因此您的编码助手可以继续专注于代码编写。
• 格式保证：翻译键、顺序、占位符和复数形式均保持不变——无需在事后清理损坏的 JSON。
• 持久记忆：词汇表和语言指令存储在我们这边，因此翻译质量不会依赖于代理碰巧记住了什么。

设置只需一条命令——以下是 Claude Code 的设置方法（Cursor、Windsurf、Copilot、Claude Desktop 和 Codex 的设置请参考指南）：

claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp

然后只需询问您的代理：“将 src/i18n/en 翻译成德语和日语。”它将自动检测您的项目结构、进行翻译并为您写入文件。

阅读 AI 本地化代理指南

CLI 和 GitHub Actions

ai-l10n NPM 包将本地化功能引入您的终端和 CI/CD 流程中。在开发时手动翻译文件，然后将相同的命令移至工作流中，这样新字符串在到达审阅者之前就已经完成了本地化。

• 项目结构检测：指向您的源文件，它会自动找到您现有的目标语言。
• 默认增量更新：使用 translateOnlyNewStrings，仅发送并计费新增或更改的字符串。
• 流水线就绪：在本地、GitHub Actions、GitLab CI 或 Jenkins 中均可使用。

安装包，存储您的 API 密钥，并翻译您的第一个文件：

npm install ai-l10n

npx ai-l10n config --api-key YOUR_API_KEY

# Auto-detects target languages from your project structure
npx ai-l10n translate ./locales/en.json --update

# Or name them explicitly
npx ai-l10n translate ./locales/en.json --languages es,fr,de --update

要在每次推送时进行翻译，请将我们的 GitHub Action 添加到您的工作流中：

name: Auto-translate i18n files

on:
  push:
    branches: [main]
    paths: ['locales/en/**']

permissions:
  contents: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: l10n-dev/ai-l10n@v1
        with:
          api-key: ${{ secrets.L10N_API_KEY }}
          config-file: 'ai-l10n.config.json'
          pull-request: false

阅读本地化自动化指南

Web 工作区

工作区是查看服务效果的最快方式——无需 API 密钥，无需安装。这也是您管理文件、词汇表、指令和余额的地方。

1. 上传您的 i18n 文件——支持 JSON、YAML、PO、XLIFF、ARB、Markdown 或纯文本。
2. 选择源语言和一种或多种目标语言。
3. 可选择附加词汇表和语言指令，并启用仅翻译新字符串的功能。
4. 点击“翻译”，查看进度，然后下载结果或直接将其复制到您的存储库中。

打开工作区

第 3 步：调整翻译质量

AI 开箱即用，已能将周围的键和文件结构作为上下文。以下两项功能可让您锁定产品的词汇和语调，并适用于上述所有路径——代理、CLI、工作区和 API。

AI 驱动的词汇表

词汇表可固定您的产品名称、功能名称和领域术语的翻译方式。启用词汇表生成功能后，l10n.dev 会根据您的源内容和已翻译内容自动构建词汇表，并将其保存为该语言对的激活词汇表——确保未来的每次翻译都保持品牌一致性。您也可以导入自己的词汇表或使用 AI 生成一个。

管理词汇表

语言指令

语言指令告诉 AI 如何写作：正式还是随意、使用哪种称呼、如何处理品牌名称、产品特定约定，或任何其他定义您品牌语调的内容。只需编写一次，即可应用于该语言的所有翻译。

管理语言指令

经验法则：使用词汇表来规定单词“是什么”，使用语言指令来规定整个文本“听起来应该是什么样”。

您还能获得什么

增量翻译

我们按内容跟踪您的源字符串，因此重新运行翻译时仅发送实际更改的部分。现有的、已审阅的翻译保持不变，您的 Git 差异保持较小，并且您只需为新文本付费。我们不会存储您的内容；内容仅通过哈希处理以检测更改，因此您的源字符串保持私密。

165 种语言和所有常见格式

翻译成 165 种语言，包括那些难以找到人工译员的语言。JSON、YAML、PO、XLIFF、ARB、Markdown、纯文本和 OpenAPI 规范均可原生处理——包括 ICU 消息和完整的 CLDR 复数形式。

格式保证和多种 LLM

每个结果都会根据源文件进行验证：如果丢失了占位符、键或结构，该块将自动重试。大文件被拆分为保持上下文的块，我们运行多种 LLM，以便每种语言和内容类型都能获得最适合的模型。

面向整个团队的集成

本地化不仅是开发者的任务。将 l10n.dev 引入您团队已经使用的工具中——包括 Figma、Obsidian 插件、VS Code 扩展、NPM 包、MCP 以及文档齐全的 REST API。

浏览所有集成

您的隐私至关重要

我们不会存储您的翻译数据。当您在工作区翻译文件时，您拥有对它们的完全控制权——可以随时删除它们。

管理您的文件

专属实例

如果您的组织需要隔离的基础设施、自己的数据库和存储、自己的模型部署或自定义合规性保证，我们可以为您运行 l10n.dev 的专属实例。

阅读关于专属实例的信息

免费额度和套餐

每个账户每月可获得 10,000 个免费字符。无需付费，无需信用卡——这足以本地化一个小型应用程序，或在您承诺购买前充分评估翻译质量。

如果您需要的额度超过每月免费配额，可以购买套餐以增加字符余额。使用与订单关联的电子邮件地址登录即可享受您的权益。

可用套餐：

• 100K Characters
  价格： $4.90
  翻译 100,000 个字符。*
• 1M Characters
  价格： $14.90
  翻译 1,000,000 个字符。*
• 5M Characters
  价格： $39.90
  翻译 5,000,000 个字符。*

*每个套餐有效期为 90 天，如果在过期前再次购买，未使用余额可结转。

比较所有套餐和定价

下一步做什么

选择符合您工作计划的下一步——或者直接翻译一个文件，亲眼看看结果。

为什么选择 l10n.dev？

l10n.dev 将 AI 的强大功能与用户友好的工具相结合，以简化您的本地化工作流程。无论您是开发者还是本地化团队的一员，我们的平台都能确保为您量身定制准确、高效且经济实惠的翻译。