動作怎麼跟 Azure 溝通?
透過 Microsoft 官方的 @azure-rest/ai-translation-text SDK 加上@azure/core-rest-pipeline層。這能讓你免費獲得408/429/5xx自動重試、輸入請求與回應模型,以及認證標頭處理——這些過去都是手動捲的axios呼叫。公開動作表(輸入、輸出、檔案輸出)保持不變。
為什麼翻譯有時會顯得不合品牌或不合常理?
機器翻譯預設採用通用模型。三個旋鈕有幫助:一個用於重寫困難詞彙的詞彙表、一個用來訓練基於你語氣和詞彙的精細模型的自訂翻譯器類別,以及用來擦除或標記髒話的profanityAction。
我該如何避免將同一個檔案翻譯兩次?
只針對與來源區域檔案相符的paths觸發工作流程,例如 **/*.en.resx。當 GITHUB_TOKEN 設定時,動作還包含每個觸發器的檔案過濾器,將工作範圍縮小到最新提交的檔案範圍。
我可以離線執行這個動作嗎?
不完全是——Azure AI 翻譯器是執行時的大腦。但你可以用 dryRun: true 來驗證解析和設定,而不需要發出任何 HTTP 的翻譯請求。
動作是在哪個節點版本上執行的?
v3 則運行在 GitHub Actions node24 執行環境上。內建的 JavaScript 相容於 Node 20、22 和 24,這也是 CI 測試的對象。
這些打包dist/從哪裡來?
GitHub JS 動作會將編譯後的 JS 寄送到倉庫。dist-build 的工作流程會在每次合併後重建,main漂移,並dist-check阻擋可能落在過時輸出的 PR。
其他資源格式呢?
今日:.resx、.xliff、.po、.json、.ini、.restext。開啟問題如果你需要另一個,解析器介面很小(解析→映射→套用翻譯→格式),歡迎大家貢獻。