常見問題
開始之前,您需要了解的關於 i18n-keyless 的一切。
我需要管理翻譯文件嗎?
不。沒有 JSON 檔案,沒有金鑰提取步驟,也沒有建置時外掛程式。您用原始語言撰寫句子,SDK 在首次請求時將它們傳送到 API,API 使用 AI 進行翻譯,之後的每次請求都從快取提供。您的程式碼是唯一的真理來源。
當我更改來源文字時會發生什麼?
原始文本就是鍵。修改它,你就會得到一個新的鍵,並獲得全新的AI翻譯。舊鍵將不再被請求,儀表板會在30天未使用後自動清理。修正拼寫錯誤也是一樣:在程式碼中修正它,部署,新文本將在首次請求時被翻譯。
多少錢?
自架設:完全免費,無限項目,無需訂閱且無使用限制 — 安裝 Docker 映像,使用您自己的 AI 金鑰。喜歡嗎?請我喝杯咖啡!託管:每個項目每月固定價格,按月活躍用戶計算 — 1,000 以內 4 歐元,5,000 以內 9 歐元,50,000 以內 29 歐元,500,000 以內 99 歐元 — 按月計費,隨時取消。兩種方案均無按座位、按字數或按字串的定價。
我可以匯出我的翻譯嗎?
是的。儀表板有一個「匯出 JSON」按鈕,可將專案中的所有翻譯下載為單個 JSON 檔案。匯出包含所有列,而不只是最近 30 天使用的列,因此這是一個完整的備份。沒有鎖定:您的資料隨時可透過一鍵存取。
它支援哪些框架?
React、React Native、Vue、Svelte、Vanilla JS、Node.js、Ruby on Rails、Python、Go、Swift 和 Kotlin。每個 SDK 的工作方式相同:將文本包裹在翻譯調用中,API 會返回當前語言的翻譯。伺服器 SDK 是執行緒安全的,並在記憶體中快取翻譯。
支援多少種語言?
48種語言,包括地區變體如zh-Hans / zh-Hant、en / en-GB、fr / fr-CA、pt / pt-BR和es / es-MX。阿拉伯語、希伯來語和烏爾都語也在列表中,因此從右到左的語言也能正常工作。在儀表板中單擊即可為專案新增語言。
它是否與伺服器端渲染一起運作?
是的。Node.js SDK 使用 AsyncLocalStorage,讓您的載入器、head 函數和伺服器元件能夠在沒有 React 提供者的情況下進行翻譯。在客戶端,React 提供者從伺服器渲染的 HTML 進行水合。文件中提供了適用於 Next.js、Nuxt 和 TanStack Start 的逐步指南。
這會減慢我的應用程式嗎?
當首次請求一個新字串時,API 會呼叫 AI 模型——短 UI 字串約需半秒,段落則需更長時間。之後的每個請求都從資料庫提供,這是常規的快取命中。SDK 也會在本地快取翻譯,因此返回的使用者不會看到任何網路延遲。如果十個使用者同時請求同一字串,只會發起一次 AI 呼叫。
如果服務中斷會發生什麼?
每個 SDK 都會在本地快取翻譯——在網頁端使用 localStorage,在行動裝置使用 AsyncStorage,在伺服器端使用記憶體。如果 API 無法存取,SDK 將提供快取的翻譯。您的用戶將看到最後一次已知的翻譯,永遠不會看到空字串。當 API 回復時,SDK 會靜默刷新。
它使用哪個AI提供商?
支援五個提供商:Mistral、OpenAI、Anthropic、Google,以及任何相容 OpenAI 的端點,例如 Ollama、Groq 或 Together。操作者可從儀表板或環境中選擇提供商和模型。在 i18n-keyless.com 上預設為 Mistral。自行託管的使用者可以在本地執行 Ollama,並不會將任何內容傳送至第三方。
我可以覆蓋AI翻譯嗎?
是的。點擊儀表板中的任意儲存格,輸入正確的文字,然後儲存。修復是永久性的:API 永遠不會覆蓋手動設定的值。您也可以透過 API 或 MCP 伺服器覆蓋翻譯,因此 AI 編碼代理可以為您修復翻譯。
我可以從 i18next 或其他程式庫遷移嗎?
是的。文件中有 i18next、react-intl 和 Lokalise 的逐步遷移指南。API 有一個遷移端點,可逐一匯入您現有的翻譯,無需 AI 呼叫且不收取任何費用。MCP 伺服器也有相同的工具,因此 AI 代理可以為您完成遷移。
有免費計劃嗎?
自託管版本完全免費,支援無限項目——安裝Docker映像,使用您自己的AI金鑰,並將資料保存在自己的伺服器上。無時間限制,無功能門控。如果您不想運行伺服器,託管計劃從每個項目每月4歐元起。
原始碼是否可用?
伺服器、儀表板和 Docker 映像在 GitHub 上以 Elastic License 2.0 發行。您可以閱讀每一行程式碼、執行程式碼並修改它。SDK(如 React、Vue、Node、Rails 等)採用 MIT 授權。唯一限制:您不得將軟體作為託管服務提供給第三方。
一位維護者:如果專案停止會發生什麼事?
SDK 採用 MIT 授權,並保留在 npm、PyPI、RubyGems 和其他註冊表中。伺服器在 Elastic License 2.0 下公開,且它們之間的協議已記錄,因此任何人都可以運行、分叉或編寫針對它的伺服器。您的翻譯會在任何時間以單個 JSON 匯出檔案保存。如果託管服務停止:已安裝的應用會繼續提供其快取的翻譯,新客戶端會回退到原始語言,而將 SDK 指向您自己的實例(透過 API_URL)即可恢復一切。您將失去的只是 i18n-keyless.com 上新字串的 AI 翻譯——而不是您的資料或應用。
閱讀完整答案,包括程式碼上下文難道不只是一個偽裝的鍵嗎?
不。每個字串都必須有一個金鑰,該金鑰必須是唯一的,並存在於你手動維護的全域命名空間中。上下文是可選的,僅附加到少數意義模糊的字串上——例如「Close」可以指關閉視窗或「接近」距離——它描述的是含義,而不是字串的名稱。大多數字串不帶上下文。原始文本始終作為查找依據,無論是否有上下文;兩個相同的文本帶有兩個不同的上下文時,它們只是兩行。
閱讀完整答案,包括程式碼我可以在拉取請求中審核副本嗎?
是的。原始字串在程式碼中,因此任何措辭變更都是審核者在拉取請求中以普通語言(而非鍵名)閱讀的差異。不在Git中的內容是其他語言的翻譯:它儲存在資料庫中,就像任何翻譯平台那樣,你可以在儀表板中審核它,其中每個儲存格的「已審核」標記將人工檢查的內容與AI生成的內容區分開來,或在JSON匯出中檢視。
閱讀完整答案,包括程式碼為什麼不選擇同樣開源的Tolgee呢?
Tolgee 是一個基於金鑰的翻譯平台,採用 Apache 2.0 授權。它支援上下文編輯、截圖上下文和翻譯記憶;如果你需要這些功能,或者需要翻譯人員參與,這是一個不錯的選擇。i18n-keyless 沒有金鑰,沒有地區設定檔,預設使用 AI 翻譯(但 AI 不會重寫手動覆蓋),伺服器採用 Elastic License 2.0,並整合 MIT SDK。此外,它還提供一個自託管映像,可在單個容器中運行 SQLite。要進行上下文修復,請截圖並將其提供給連接到 MCP 伺服器的 AI 代理:它會找到字串並覆蓋翻譯。文件中的對比頁面會將價格並排顯示。
閱讀完整答案,包括程式碼自架設還是訂閱:選擇哪一個?
自架設:在您自己的伺服器上使用完全相同的 Docker 映像,完全免費且專案無限,擁有自己的 AI 金鑰和本地資料。喜歡嗎?給我小費!訂閱:我們運行它,更新自動進行,每個專案每月僅需 4 歐元起。如果您不想運行伺服器,請選擇訂閱。
閱讀完整答案,包括程式碼如何處理動態值,例如姓名或計數?
使用替換選項。編寫帶有佔位符的句子 — "你好 {name},你有 {count} 個項目" — 並在渲染時透過 replace 傳遞值:{ "{name}": userName, "{count}": String(n) }。AI 看到佔位符並將其保留在每個翻譯中。SDK 在運行時替換值。
我如何處理複數形式?
撰寫一個包含 {count} 的格式,其中數字會被替換,並將數字作為 count 傳遞。API 為每種語言儲存一條 ICU 複數訊息,包含該語言所需的確切格式——法語為兩個,俄語為四個,阿拉伯語為六個——並透過 Intl.PluralRules 驗證,SDK 會選擇正確的格式。為排名新增序數(1st、2nd)。你永遠不需要自己撰寫分支。
閱讀完整答案,包括程式碼我如何處理性別?
在 select 中傳遞值 — select={{ gender: "female" }} — 然後模型會為每個值在每種語言中寫出一個變體,並考慮語言需求。值是封閉集合中的標識符,每個變量最多10個,每個句子最多2個變量;可以組合 select 和計數。像姓名這樣的開放值仍然是替換。
閱讀完整答案,包括程式碼如何格式化日期、數字和貨幣?
SDK 不會格式化它們,而是由你的運行時處理。使用 Intl.DateTimeFormat 和 Intl.NumberFormat,結合 SDK 中的當前語言,然後用 replace 將結果插入句子。一句話,一句翻譯,每種語言都有正確的格式。
閱讀完整答案,包括程式碼我可以自訂翻譯提示嗎?
不,你也不需要這麼做。提示會讀取每個鍵的上下文:這就是語氣、受眾和含義所在的地方,也是讓同一個詞在不同地方翻譯不同的原因。任何翻譯都可以在儀表板中手動覆蓋;API 永遠不會覆蓋你寫的內容。
閱讀完整答案,包括程式碼它有用於AI編碼代理的MCP伺服器嗎?
是的。API 也是一個 MCP 伺服器,採用 OAuth 2.1 認證。AI 代理可以列出翻譯、翻譯字串、覆蓋值、匯入現有翻譯,並管理專案成員——與人類在儀表板中執行的相同操作。透過 Claude Code、Cursor、Windsurf 或任何相容 MCP 的用戶端連接它。
我可以用它來處理後端字串和電子郵件嗎?
是的。Node.js、Ruby on Rails、Python 和 Go SDK 在伺服器上執行。像翻譯 UI 字串一樣翻譯郵件主旨、錯誤訊息或推播通知。伺服器 SDK 會將翻譯快取在記憶體中並在背景重新整理,因此它們不會增加您的請求延遲。
我的整個團隊可以一起處理翻譯嗎?
是的。從儀表板或透過API將團隊成員新增到專案中。每個成員都可以檢視所有翻譯、覆蓋任何值並新增語言。管理員建立專案並管理成員。沒有按席位定價:根據需要新增任意數量的人員。
如何修復輸入錯誤?
來源文字就是金鑰。修正來源文字中的錯字後,你會得到一個新的金鑰及其全新的翻譯;舊字串不再被要求,儀表板會在30天未使用後自動清理。翻譯中的錯字:在儀表板中編輯儲存格,修正將永久生效。
閱讀完整答案,包括程式碼