l10n.dev 快速入門

l10n.dev 是一個為開發人員和本地化團隊打造的 AI 本地化平台。它能翻譯您的 i18n 檔案，同時保留鍵值、結構、佔位符和複數形式——無論是透過您的 AI 本地化代理、終端機、CI 管線還是網頁工作區。本頁面將引導您完成首次翻譯，並展示平台設定完成後的功能。

步驟 1：建立帳號

建立您的 API 金鑰

網頁工作區以外的所有功能——包括 AI 本地化代理、CLI、GitHub Action、插件和 API——皆使用 API 金鑰進行驗證。請在以下頁面建立一個：API 金鑰 頁面，並妥善保存：您將需要將其貼入您的代理設定、CLI 設定或 CI 密鑰中。您可以隨時撤銷並重新發行金鑰。

步驟 2：選擇您的本地化方式

有三種方式可以使用 l10n.dev。它們共享相同的翻譯引擎、字元額度、詞彙表和語言指令——因此請選擇最適合您目前工作流程的方式，之後也可以混用。

AI 本地化代理 (MCP)

將您的 AI 本地化代理連接到我們的 MCP 伺服器，即可將其轉變為專業的本地化工具。代理不再需要自行翻譯字串（這會消耗語境並導致執行間的偏移），而是呼叫 l10n.dev 作為專用的翻譯引擎，並取回完成的檔案。就像您的團隊中多了一位本地化專家。

• Token 效率高：翻譯內容永遠不會經過您代理的語境視窗，因此您的程式助理可以專注於程式碼工作。
• 格式保證：鍵值、順序、佔位符和複數形式都能完整保留——不會產生需要事後清理的損壞 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

閱讀本地化自動化指南

網頁工作區

工作區是了解服務產出結果最快的方式——無需 API 金鑰，無需安裝。您也可以在此管理檔案、詞彙表、語言指令和額度。

1. 上傳您的 i18n 檔案——支援 JSON、YAML、PO、XLIFF、ARB、Markdown 或純文字。
2. 選擇來源語言和一種或多種目標語言。
3. 可選擇附加詞彙表和語言指令，並啟用僅翻譯新字串的功能。
4. 按下「翻譯」，觀察進度，然後下載結果或直接複製到您的儲存庫中。

開啟工作區

步驟 3：調整翻譯品質

AI 開箱即用，能將周圍的鍵值和檔案結構視為語境。這兩項功能讓您能鎖定產品的詞彙和語氣，並適用於上述所有路徑——包括 AI 本地化代理、CLI、工作區和 API。

AI 驅動的詞彙表

詞彙表能確保您的產品名稱、功能名稱和領域術語得到正確翻譯。啟用詞彙表產生功能後，l10n.dev 會自動根據您的來源和翻譯內容建立一個詞彙表，並將其儲存為該語言對的活動詞彙表——確保未來的每次翻譯都保持品牌一致性。您也可以匯入自己的詞彙表或使用 AI 產生一個。

管理詞彙表

語言指令

語言指令告訴 AI 如何書寫：正式或非正式、使用哪種稱呼方式、如何處理品牌名稱、產品特定慣例，或任何定義您語氣的事項。編寫一次，即可應用於該語言的所有翻譯。

管理語言指令

經驗法則：使用詞彙表來定義詞彙「該變成什麼」，使用語言指令來定義「整個文字聽起來應該是什麼感覺」。

您還能獲得什麼

增量翻譯

我們根據內容追蹤您的來源字串，因此重新執行翻譯時，只會發送實際變更的部分。現有的、已審核的翻譯保持不變，您的 Git diff 保持簡潔，且您只需為新文字付費。我們不會儲存您的內容；內容僅會被雜湊以偵測變更，因此您的來源字串保持私密。

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 的強大功能與易於使用的工具，簡化您的本地化工作流程。無論您是開發者還是本地化團隊的一員，我們的平台都能確保為您提供準確、高效且實惠的翻譯。