您的第一次翻譯。

在您的電腦上開始，翻譯一個小檔案，並查看您的應用程式將收到的確切內容。

本頁內容

您將設定的內容

EveryLocale 同時執行背景服務和瀏覽器工作區。服務負責翻譯；工作區讓您選擇語言並處理審核。您將建立一個專案，將三條英文訊息翻譯成德文，並下載一個具有相同鍵和變數的 JSON 檔案。

您需要 Node.js 22.16 或更新版本、pnpm 9.15.9，以及存取雲端或本機模型。EveryLocale 是免費軟體；雲端模型請求使用您提供者的額度。

1. 安裝並建立您的設定

開啟終端機並執行這些命令。它們會下載 EveryLocale 並在其資料夾中建立名為 .env 的私密設定檔。

終端機

git clone --branch develop https://github.com/bomsn/EveryLocale.git
cd EveryLocale
pnpm install --frozen-lockfile
pnpm build
pnpm run setup

在文字編輯器中開啟 .env。設定已產生您的工作區登入權杖和個別的工作階段密鑰。請妥善保管。如果檔案已存在，請開啟它，而不要再次執行設定。

2. 選擇模型

一個請求會建立翻譯；另一個請求會審查其意義和措辭。您可以為兩個角色使用相同的模型。此範例透過 OpenRouter 使用 Claude Sonnet 4.6。取代 .env 中的相符設定，並在兩個金鑰欄位中放入您自己的 OpenRouter API 金鑰。

模型設定

EVERYLOCALE_GENERATOR_URL=https://openrouter.ai/api/v1
EVERYLOCALE_GENERATOR_KEY=YOUR_OPENROUTER_KEY
EVERYLOCALE_GENERATOR_MODEL=anthropic/claude-sonnet-4.6
EVERYLOCALE_GENERATOR_INPUT_PRICE=3
EVERYLOCALE_GENERATOR_OUTPUT_PRICE=15
EVERYLOCALE_REVIEWER_URL=https://openrouter.ai/api/v1
EVERYLOCALE_REVIEWER_KEY=YOUR_OPENROUTER_KEY
EVERYLOCALE_REVIEWER_MODEL=anthropic/claude-sonnet-4.6
EVERYLOCALE_REVIEWER_INPUT_PRICE=3
EVERYLOCALE_REVIEWER_OUTPUT_PRICE=15

價格為每百萬個權杖的美元。翻譯前請檢查模型的目前費率。這些設定可協助 EveryLocale 編列請求預算；它們不會變更提供者的帳單。您可以在模型設定指南中選擇另一個雲端模型或本機端點。

3. 檢查設定並開啟工作區

終端機

pnpm doctor
pnpm start

Doctor 會檢查您的設定和資料庫，而不會提出付費請求。如果它報告遺漏的設定，請修正該設定並再次執行。保持服務終端機開啟，然後在瀏覽器中造訪 http://localhost:4310。

使用來自 .env 的 EVERYLOCALE_ADMIN_TOKEN 登入。您的第一次翻譯將驗證實際的提供者存取；單獨的設定檢查無法驗證 API 金鑰。

4. 建立您的第一個專案

選擇 New project。將其命名為 My first app，使用 first-app 作為其識別碼，並保持英文作為原始語言。選擇德文並清除此首次試用的其他目標語言核取方塊。設定總翻譯預算為 $1。

選擇 Automatic approval。檢查和 AI 審查後可下載通過檢查的翻譯。重大問題仍在等待處理。如果您想自行核准每個結果，請改為選擇 Human review gate。

5. 翻譯範例

開啟 Content → Add content，選擇 Use sample messages，並保持內容名稱 messages 和 JSON 格式。範例包含：

範例訊息

{
  "welcome": "Welcome, {name}!",
  "createProject": "Create a project",
  "saved": "Your changes are saved."
}

選擇 Import content。匯入會儲存英文文字，不會呼叫模型。為此內容選擇德文，然後選擇 Translate changes。開啟 Review 以追蹤進度並檢查任何發現。

在自動模式中，通過檢查的結果會被核准。如果審查發現問題，請更正措辭並儲存以進行另一次審查。人工審核專案需要您的核准才能下載。

6. 下載並嘗試變更

返回 Content，開啟 messages，選擇德文，然後選擇 Download approved。JSON 保持相同的鍵並保留 {name}。您的應用程式可以用人名替換該變數。

Preview比較完整的檔案。Connect → Export approved 下載包含 EveryLocale 執行時期核准資訊的目錄；Download approved 提供您原始檔案格式。

現在編輯原始範例，使用相同的內容名稱重新匯入，然後選擇 Translate changes。只有變更的文字需要新工作。核准後，下載更新的檔案。

在您的應用程式中使用

如果需要注意

翻譯無法使用： 設定兩個模型，執行 pnpm doctor，然後重新啟動。
提供者錯誤： 檢查金鑰、模型、端點和可用額度；修正原因並重試失敗的工作。
預算已用盡： 檢查記錄的支出，然後提高專案的總限額。
下載不完整： 完成所選語言中每個目前訊息的審查。

完整的入門指南涵蓋安裝疑難排解。對於共用伺服器或 Docker，在您的第一次翻譯成功後，使用託管和復原指南。