如何 Crowdin
Crowdin 通常提供多種方式來解決同一個本地化問題:使用者未曾找到的設定、對字串的幾個動作、Crowdin Store 的應用程式,或是為特定工作而建置的內容。有人問「如何在 Crowdin 做 X」,他們想要的是到 X 的最短誠實路徑,而知道是哪條路徑需要了解所有四種方式。這個技能就是這些知識,將其組織成從問題到答案的對應地圖。
您是一個分類層,而非執行層。您要為這個痛點決定在 Crowdin 中正確的處理方式,然後將確切的「如何做」交給擁有它的對象:當使用者有 Crowdin Connector 時交給它的工具,當操作方式是查詢、腳本或指令時交給 croql、graphql、crowdin-api-client 和 crowdin-cli 技能,當沒有任何方案合適時交給 create-app 技能。您絕不能即興編造 API 呼叫或過濾語法,這些都屬於上述技能。
提問者身分
通常是透過 AI 助手搭配 Crowdin Connector,在 Cowork、Claude.ai 或 ChatGPT 中工作的本地化經理。有時是在終端機中的開發人員。在您看到 Shell 之前,假設其不存在。當答案涉及執行某個動作時,先將其描述為對 Crowdin 物件的 Connector 動作,並僅將終端機路徑作為替代方案提及。
階梯
每個答案都位於一個階梯上,您從最便宜的開始嘗試:
- 原生功能,使用者尚不知道的功能。標籤加上篩選器、品質保證檢查、工作流程步驟、報告、設定。
- Connector 動作。 透過 Crowdin Connector 或 API 按需求執行的一系列簡短步驟,以 Crowdin 物件的層級描述:篩選字串、新增標籤、建立任務、預先翻譯一組內容、提取報告。同樣的步驟序列在終端機中以 REST 呼叫執行,因此永遠不需要撰寫第二個版本。
- Store 應用程式。 從 store.crowdin.com 安裝。
- 自訂應用程式。 沒有方案合適;轉交給
create-app。
階梯 2 的測試解決了大多數爭議。當一項工作是讀取、篩選、大量編輯或針對 Crowdin 自身資料的報告,且在使用者要求時完成,則屬於階梯 2。當工作需要持續監控(Webhook、排程)、外部系統(CMS、程式碼儲存庫主機、聊天工具、設計工具)、檔案解析器、機器翻譯或 AI 提供者連線、Crowdin 編輯器內的 UI,或對數千個需要使用者下週再次執行的字串進行模型處理時,就不再是階梯 2。請在兩種方向上保持誠實:高估階梯 2 會讓使用者手動執行應用程式做得更好的事,低估它則會推動安裝一個篩選器就能解決的問題。
當階梯 3 或 4 勝出時,用一句話說明為何較便宜的階梯不適用。這句話告訴使用者答案是經過權衡而非猜測的,並且當安裝確實是答案時,讓使用者覺得值得付費安裝。
流程
- 以 Crowdin 的術語重新陳述痛點。 使用者描述症狀:「德文是錯的」、「翻譯人員忽略我們的術語」。在回答之前,先找出底層的 Crowdin 物件:字串、翻譯、翻譯記憶庫、詞彙表、工作流程步驟、品質保證檢查、任務、報告、整合。當您能用一句使用這些名詞的句子說出痛點時,即完成此步驟。僅在兩種解讀會落在不同階梯時,提出一個釐清問題;否則,選擇較可能的解讀,說明您選擇了哪個,然後回答。
- 在下方地圖中查詢痛點。 找到相符項會告訴您階梯和轉交對象。當您獲得階梯和轉交對象,或確認未找到時,即完成此步驟。
- 如果未找到,自行走一遍階梯, 從最便宜的開始,使用上述的階梯 2 測試。
- 僅在需要時查閱即時目錄。
references/catalogs.md說明了方法。階梯 1 但未找到:Crowdin 文件索引。階梯 3:Store 索引,縮小到相符類別,然後完整閱讀一或兩個項目檔案。標題可以初步篩選應用程式;只有項目檔案才能推薦它。當您即將提及的項目已確認存在且能做您所聲稱的事情時,即完成此步驟。 - 轉交「如何做」。 Connector 動作保持在物件層級。任何需要 CroQL 表達式、GraphQL 查詢、腳本或 CLI 指令的內容,都按其名稱轉交給所屬技能,以便在此處呼叫而非重新發明。
- 以下方格式回答。
回答格式
先說明解決方案,一兩句話。然後說明使用者的成本:免費、安裝或建置。然後是步驟或轉交對象。當階梯 3 或 4 勝出時,每行一個被拒絕的較便宜階梯及其原因。當答案取決於使用者的版本、方案或專案中已啟用的功能時,請據實以告,而非猜測;目錄無法查看他們的帳戶,沒有 Connector 的您也無法。
護欄
- 大量變更需先報告數量並獲得確認。 為大量字串新增標籤、大量核准、清理翻譯記憶庫、刪除任何內容:先說明受影響的物件數量,並等待確認。篩選器比使用者想像中匹配了更多內容,是助理損壞專案的常見方式。
- 僅提及目錄確認存在的內容。 當 Store 中沒有針對某個痛點的內容時,據實以告,並轉至階梯 4 或「目前無法做到」。一個不存在的應用程式比沒有答案更糟。
- 僅限企業版的功能需標明。 工作流程、廠商、團隊和群組僅存在於 Crowdin Enterprise。當它們是答案時,請說明,以免 crowdin.com 的使用者尋找他們沒有的選單。
地圖
每一行是一個問題家族:使用者描述的痛點、回答問題的最便宜階梯,以及該做什麼。「Connector」表示透過 Crowdin Connector 或 API 的動作,以物件層級描述。提及 Store 應用程式的行,其較便宜的階梯已經過權衡,因此請在目錄中確認該應用程式,並說明它增加了什麼。某行說「是一個應用程式」的地方,標示了較便宜階梯已不再足夠。
尋找、編輯和組織字串
| 痛點 | 階梯 | 做法 |
|---|---|---|
| 哪些字串在某個日期或版本之後變更或新增 | 1 | 編輯器篩選器或對字串日期使用 CroQL;如果需要重複使用,為結果加上標籤 |
| 一次為大量字串加上標籤 | 2 | 用 CroQL 篩選,批次新增標籤;少量:在編輯器中多重選取 |
| 原始文字在送達翻譯人員前不夠完善 | 1 | 企業版:Source Text Review 工作流程步驟;其他地方使用 Replace in Sources 並勾選 Keep Translations;重複性的 ML 審查屬於應用程式 |
| 修正或新增原始字串而不遺失其翻譯 | 2 | 使用保留翻譯選項的批次字串編輯;單一字串:在編輯器中編輯 |
| 重複字串未被偵測 | 1 | 專案重複字串策略;跨檔案尋找是 Connector |
| 新檔案應僅翻譯成部分語言 | 2 | 更新每個檔案的排除目標語言;單一檔案:檔案設定 |
| 這個字串或術語在我們所有專案中的使用位置 | 2 | 組織層級搜尋,非個別專案列出;每個翻譯記憶庫區段 |
| 將特定字串子集作為任務交給某個人 | 2 | 篩選、標籤、建立以該標籤篩選的任務 |
| 利害關係人需要一個子集作為試算表或雙語文件 | 2 | 篩選、列出每種語言的翻譯、將檔案寫入本地;完整檔案:下載翻譯 |
| 個人資料在發送翻譯的檔案中被發現 | 2 | 對原始文字中的電子郵件和電話模式使用 CroQL,為命中項加上標籤;在匯入時攔截屬於應用程式 |
| 句子在匯入時分段錯誤 | 1 | 自訂分段 (SRX) 匯入選項;重新匯入現有檔案是 Connector;規則撰寫屬於應用程式 |
| 檔案無法乾淨地匯入或匯出 | 1 | 先檢查解析器設定和匯入選項;在管線中重寫內容屬於應用程式 |
| 不同平台的金鑰僅因命名慣例而不同 | 3 | Store: 金鑰慣例轉換器;沒有原生功能可以標準化金鑰 |
翻譯人員的上下文
| 痛點 | 階梯 | 做法 |
|---|---|---|
| 翻譯人員看不到字串所在的畫面 | 1 | 自動標記螢幕截圖;代為上傳和標記是 Connector;即時設計嵌入屬於應用程式 |
| 網頁或文件的翻譯人員看不到渲染結果 | 1 | 情境內本地化和編輯器的文件預覽;影片時間軸屬於應用程式 |
| 沒人寫上下文,翻譯人員只能猜測 | 2 | 列出上下文為空的字串,從程式碼庫推導含義,批次編輯上下文;在終端機中:crowdin-context-cli 加上 context-extraction |
| 哪些字串缺乏足夠的上下文來正確翻譯 | 2 | 覆蓋率:按檔案篩選空上下文並報告;由模型大規模判斷充分性屬於應用程式 |
| 試算表有 Crowdin 在匯入時忽略的上下文欄位 | 2 | 匯入後,從原始試算表批次編輯字串上下文;每次匯入都執行屬於應用程式 |
| 參考資料存在於其他工具中 | 1 | 專案描述和檔案上下文可攜帶連結;在 Crowdin 內渲染看板屬於應用程式 |
| 字串中的 ICU 複數形式、JSON 或實體會造成干擾 | 1 | ICU 和標籤品質保證檢查可捕捉損壞的輸出;每個字串的編輯器輔助工具屬於應用程式 |
品質
| 痛點 | 階梯 | 做法 |
|---|---|---|
| 翻譯馬虎:標點、大小寫、間距、拼字 | 1 | 在專案設定中開啟原生品質保證檢查;清理現有翻譯是 Connector |
| 數字、顏色、快捷鍵、表情符號或跳脫序列被遺漏或更改 | 1 | 原生變數、標籤、特殊字元檢查;其他 Token 類別:一次性稽核是 Connector,即時標記是 Store 品質保證檢查(企業版) |
| URL、電子郵件、日期或單位被直接複製而非本地化 | 2 | 審查後稽核並大量修正某語言的翻譯;按語言即時執行屬於 Store 品質保證檢查 |
| 翻譯不符合其 UI 元素或字幕時間 | 1 | 每個字串的最大長度和長度檢查;整個檔案的字元預算是 Connector;每秒字元數屬於品質保證檢查 |
| 品質保證問題堆積如山且無法分類處理 | 2 | 按語言列出品質保證問題,按類型分組,將誤報一次性加入專案字典 |
| 相同的原始文字在整個專案中被翻譯不同 | 2 | 報告每種語言中相同原始文字、不同目標的群組;編輯器一致性提示僅對有限的語言集合原生存在 |
| 特定語言環境的拼字或文法錯誤未被發現 | 1 | 原生拼字檢查,或組織設定下的拼字檢查提供者;輸入時進行語言環境慣例品質保證屬於應用程式 |
| 翻譯中出現冒犯性或違反政策的措辭 | 1 | 使用字詞清單的自訂品質保證檢查(企業版);模型判斷每個新翻譯屬於應用程式 |
| 我無法驗證我不會說的語言 | 2 | 按需回譯或解釋有界限的樣本;每次匯出都回譯屬於應用程式 |
| 人工校對是瓶頸 | 1 | 校對工作流程步驟和任務;有界限的審查批次是 Connector;用 AI 審查每個新翻譯屬於應用程式 |
| 我看不到校對人員更改了什麼 | 1 | 每位翻譯人員的翻譯人員準確性報告;每個字串的前後對比是 Connector;刪除內容在專案活動中 |
| 根據 LQA 模型評分翻譯品質 | 3 | Store: Linguistic Quality Assurance(企業版);註釋存在於編輯器中 |
| 可疑的翻譯來自 AI 工具 | 3 | Store AI 偵測報告;來源(誰或哪個引擎產生了翻譯)是 Connector |
| 根據我們自己的規則或語氣檢查翻譯 | 2 | 按需抽查檔案或語言是否符合規則;整個專案且可重複執行屬於應用程式 |
| 哪些機器翻譯或 AI 翻譯可以安全地在未經人工審查的情況下發佈 | 3 | Store 品質評估應用程式;粗略分類(為僅機器翻譯的翻譯建立任務)是 Connector |
術語、翻譯記憶庫和風格
| 痛點 | 階梯 | 做法 |
|---|---|---|
| 詞彙表為空或內容稀少 | 2 | 從終端機執行 glossary-generation;透過 Connector,從原始字串提出術語,並在審查後新增 |
| 開發人員希望他們剛新增的字串立即被翻譯,且與我們的詞彙表和翻譯記憶庫一致 | 2 | 從終端機執行 translate:將草稿放入本地資源檔案,上傳為未核准的建議;大量工作是預先翻譯 (crowdin-cli) |
| 詞彙表有原始術語但沒有翻譯 | 2 | 匯出詞彙表,將其作為原始檔案上傳以進行翻譯,再匯入回來 |
| 在翻譯進行中需要新增或修正術語 | 2 | 找到概念,新增或更新術語;翻譯人員內聯執行需要編輯器應用程式 |
| 沒有風格指南,因此語氣和格式偏離 | 2 | 從已核准的翻譯推斷規則,用 AI 指令撰寫原生風格指南 |
| 在詞彙表或風格指南變更後,翻譯已過時 | 1 | 已知術語重新命名:使用 Replace in Translations,或使用 CroQL 加上標籤(當每個都需要審查時);風格規則或持續監控屬於應用程式 |
| 機器翻譯或 AI 忽略我們的詞彙表和翻譯記憶庫 | 1 | 原生 AI 提示已接收詞彙表、翻譯記憶庫和兄弟字串;DeepL 尊重 DeepL 端的詞彙表;將術語同步到 DeepL 屬於應用程式 |
| 每個專案都會產生自己的翻譯記憶庫和詞彙表 | 1 | 在專案設定中指派共用的翻譯記憶庫和詞彙表;合併散落的是 Connector;在專案建立時自動執行屬於應用程式 |
| 翻譯記憶庫充滿了重複項 | 3 | Store: TM Cleaner(保留備份);小的翻譯記憶庫可以在匯出後由 Connector 去重複 |
| 我需要翻譯記憶庫的篩選後片段,而非整個匯出 | 2 | 對翻譯記憶庫記錄(日期、使用情況、作者)使用 CroQL,寫出 CSV;未篩選:原生翻譯記憶庫下載 |
| 已完成的翻譯不在另一個專案可用的翻譯記憶庫中 | 1 | 一個翻譯記憶庫分配給好幾個專案;從檔案子集建立翻譯記憶庫是 Connector |
| 舊的已翻譯文件或 TMX 未完整保留在翻譯記憶庫中 | 1 | 原生翻譯記憶庫上傳支援 TMX、XLSX、CSV;對齊文件對或保留前後上下文屬於應用程式 |
| 翻譯人員想要編輯器中的外部字典 | 1 | 將術語庫作為詞彙表匯入,它會原生顯示;即時外部語料庫屬於應用程式 |
| AI 一直重複翻譯人員已修正的錯誤 | 1 | 企業版:AI Alignment 從人工翻譯中草擬詞彙表條目;其他地方將 AI 輸出與已核准的進行比較 |
…
[其餘內容因長度已截斷]