co-op-translator

命令參考

Co-op Translator CLI 提供多種選項以自訂翻譯流程:

Command Description
translate -l “language_codes” 將您的專案翻譯成指定語言。範例:translate -l “es fr de” 會翻譯成西班牙語、法語和德語。使用 translate -l “all” 將翻譯成所有支援語言。
translate -l “language_codes” -u 透過刪除現有翻譯並重新建立來更新翻譯。警告:此操作會刪除指定語言的所有現有翻譯。
translate -l “language_codes” -img 僅翻譯圖片檔案。
translate -l “language_codes” -md 僅翻譯 Markdown 檔案。
translate -l “language_codes” -nb 僅翻譯 Jupyter 筆記本文件 (.ipynb)。
translate -l “language_codes” –fix 根據先前評估結果重新翻譯信心度低的檔案。
translate -l “language_codes” -d 啟用除錯模式以詳細記錄日誌。
translate -l “language_codes” –save-logs, -s 將 DEBUG 級別日誌保存至 /logs/(控制台仍受 -d 控制)
translate -l “language_codes” -r “root_dir” 指定專案的根目錄
translate -l “language_codes” -f 使用快速模式進行圖片翻譯(最高可達 3 倍速度,略微犧牲品質與對齊)。
translate -l “language_codes” -y 自動確認所有提示(適用於 CI/CD 流程)
translate -l “language_codes” –add-disclaimer/–no-disclaimer 啟用或停用在翻譯的 markdown 與筆記本中加入機器翻譯免責聲明區塊(預設:啟用)。
translate -l “language_codes” –repo-url “https://github.com/org/repo.git” 使用您的儲存庫 URL 個人化 README 語言區段建議(稀疏檢出)。
translate -l “language_codes” –help CLI 內顯示可用命令的說明
evaluate -l “language_code” 評估特定語言的翻譯品質並提供信心分數
evaluate -l “language_code” -c 0.8 使用自訂信心門檻評估翻譯
evaluate -l “language_code” -f 快速評估模式(僅規則式,無 LLM)
evaluate -l “language_code” -D 深度評估模式(僅 LLM,較為詳盡但較慢)
evaluate -l “language_code” –save-logs, -s 將 DEBUG 級別日誌保存至 /logs/
migrate-links -l “language_codes” 重新處理翻譯後的 Markdown 檔案,以更新連結到筆記本 (.ipynb)。優先使用已翻譯的筆記本,否則可回退至原始筆記本。
migrate-links -l “language_codes” -r 指定專案根目錄(預設:當前目錄)。
migrate-links -l “language_codes” –dry-run 顯示將會更改的檔案但不寫入更改。
migrate-links -l “language_codes” –no-fallback-to-original 當缺少翻譯版筆記本時,不將連結改寫回原始筆記本(只更新存在的翻譯連結)。
migrate-links -l “language_codes” -d 啟用除錯模式以詳細記錄日誌。
migrate-links -l “language_codes” –save-logs, -s 將 DEBUG 級別日誌保存至 /logs/
migrate-links -l “all” -y 處理所有語言並自動確認警告提示。

使用範例

  1. 預設行為(新增翻譯而不刪除現有翻譯): translate -l “ko” translate -l “es fr de” -r “./my_project”

  2. 僅新增韓文圖片翻譯(不刪除現有翻譯): translate -l “ko” -img

  3. 更新所有韓文翻譯(警告:此操作會先刪除所有現有韓文翻譯再重新翻譯): translate -l “ko” -u

  4. 僅更新韓文圖片(警告:會先刪除所有現有韓文圖片再重新翻譯): translate -l “ko” -img -u

  5. 僅新增韓文 Markdown 翻譯,不影響其他翻譯: translate -l “ko” -md

  6. 根據先前評估結果修正低信心翻譯: translate -l “ko” –fix

  7. 僅修正特定檔案的低信心翻譯(Markdown): translate -l “ko” –fix -md

  8. 僅修正特定檔案的低信心翻譯(圖片): translate -l “ko” –fix -img

  9. 使用快速模式進行圖片翻譯: translate -l “ko” -img -f

  10. 使用自訂門檻修正低信心翻譯: translate -l “ko” –fix -c 0.8

  11. 除錯模式範例: - translate -l “ko” -d:啟用除錯紀錄。
  12. 保存日誌到檔案: translate -l “ko” -s
  13. 控制台 DEBUG 與檔案 DEBUG: translate -l “ko” -d -s
  14. 翻譯時不加入機器翻譯免責聲明: translate -l “ko” –no-disclaimer

  15. 為韓文翻譯遷移筆記本連結(有翻譯時更新為翻譯版筆記本連結): migrate-links -l “ko”

  16. 乾跑遷移連結(不寫入檔案更改): migrate-links -l “ko” –dry-run

  17. 只在存在翻譯筆記本時更新連結(不回退到原始筆記本): migrate-links -l “ko” –no-fallback-to-original

  18. 處理所有語言並提示確認: migrate-links -l “all”

  19. 處理所有語言並自動確認: migrate-links -l “all” -y
  20. 為 migrate-links 保存日誌到檔案: migrate-links -l “ko ja” -s

  21. 使用您的儲存庫 URL 個人化 README 語言建議: translate -l “ko” –repo-url “https://github.com/org/repo.git”

評估範例

[!WARNING]
Beta 功能:評估功能目前處於 Beta 階段。此功能主要用於評估翻譯後的文件,評估方法與詳細實作仍在開發中,未來可能會有所變動。

  1. 評估韓文翻譯: evaluate -l “ko”

  2. 使用自訂信心門檻評估: evaluate -l “ko” -c 0.8

  3. 快速評估(僅規則式): evaluate -l “ko” -f

  4. 深度評估(僅 LLM): evaluate -l “ko” -D


免責聲明
本文件使用 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們力求準確,但請注意,自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於重要資訊,建議採用專業人工翻譯。我們不對因使用此翻譯版本而引起的任何誤解或誤譯承擔責任。