translate

翻譯技能是為學術研究人員與 AI 代理設計的專業工具，專門處理文獻內容。它能將結構化的研究文件翻譯成多種語言（中、英、日、韓、德、法、西），同時維持複雜科學格式的完整性。透過段落感知分塊與启发式語言偵測，確保數學公式、程式碼片段與圖片引用在翻譯過程中保持正確對應。此技能非常適合處理大型論文庫的使用者，協助跨越語言障礙，同時保留研究、寫作或分析所需的技術語境。

• 分段併發處理以最大化翻譯速度，並透過終端即時顯示進度。
• 強大的錯誤處理機制，包含針對個別分塊的超時重試與指數退避策略，避免因網路波動導致整個任務失敗。
• 智慧型狀態管理，將進度記錄在臨時工作目錄中，支援任務中斷後的無縫續傳。
• 支援產生可攜式套件，將譯文檔案及其對應資源（圖片）隔離至專屬目錄，方便分享。
• 支援批次處理以及整合於標準研究管線，實現論文自動化豐富化作業。

使用注意事項與限制：

• 目標語言與併發設定可於 config.yaml 中調整，亦可透過 CLI 參數覆蓋。
• 使用 --force 參數可強制重置特定論文的翻譯任務，並清除所有舊的臨時檔案。
• 使用 --portable 參數會於 workspace/_system/translation-bundles/ 產生獨立的譯文套件，確保圖片在原目錄結構外仍能存取。
• 本工具專為 Markdown 格式的論文設計。若來源為 PDF，請確保已完成預處理的 PDF 轉 Markdown 管線步驟。
• 由於屬於高資源消耗任務，建議使用者根據 API 限制調整 chunk_size 與 concurrency 參數以取得效能平衡。