name: pdf-translate description: "Translate PDF scientific papers with bilingual comparison output while preserving formulas, charts, tables of contents, and annotations. Based on pdf2zh-next (BabelDOC). Triggered when the user needs to translate PDF documents (especially English-Chinese), generate bilingual comparison PDFs, translate specific pages, or batch-process multiple PDFs. Supports Google, DeepL, OpenAI, DeepSeek, SiliconFlow and other translation backends."
將 PDF 文件(尤其是學術論文)翻譯為中文,保留公式、圖表、目錄和註釋。預設輸出雙語對照 + 純譯文兩個檔案。
pdf2zh_next input.pdf --lang-out zh-CN
首次執行會下載模型資源(約 500MB,含 CMap 字型對映和 DocLayout-YOLO 模型),之後即用即翻。
推薦通過 uv 安裝(macOS 首選):
pip install uv
uv tool install --python 3.12 pdf2zh-next
安裝後二進位制路徑通常在:
- macOS: ~/Library/Application Support/uv/tools/pdf2zh-next/bin/pdf2zh_next
- Linux: ~/.local/bin/pdf2zh_next
如果終端找不到命令,用完整路徑呼叫即可。
執行 pdf2zh_next --version 確認安裝成功。
pdf2zh_next paper.pdf --lang-in en --lang-out zh-CN
pdf2zh_next paper.pdf --lang-in zh-CN --lang-out en
pdf2zh_next paper.pdf --pages 1-5,7,10-12 --lang-out zh-CN
pdf2zh_next paper.pdf --no-dual --lang-out zh-CN
pdf2zh_next paper.pdf --output /path/to/dir --lang-out zh-CN
pdf2zh_next file1.pdf file2.pdf file3.pdf --lang-out zh-CN
預設使用 SiliconFlow 免費引擎(無需 API key)。若免費引擎質量不足或需要更快速度,可切換:
# Google 翻譯(免費,需網路)
pdf2zh_next paper.pdf --google --lang-out zh-CN
# DeepL(需配置 API key)
pdf2zh_next paper.pdf --deepl --lang-out zh-CN
# OpenAI / DeepSeek(需配置 API key,質量最好)
pdf2zh_next paper.pdf --openai --lang-out zh-CN
pdf2zh_next paper.pdf --deepseek --lang-out zh-CN
| 引數 | 說明 |
|---|---|
--lang-in <code> |
源語言,省略則自動檢測 |
--lang-out <code> |
目標語言,中譯用 zh-CN |
--pages <range> |
頁碼範圍,如 1-5,7,10-12 |
--output <dir> |
指定輸出目錄 |
--no-dual |
不生成雙語對照檔案 |
--no-mono |
不生成純譯文檔案 |
--dual-translate-first |
雙語模式下譯文頁在前 |
--qps <n> |
翻譯速率限制(預設不限) |
--debug |
輸出詳細除錯資訊 |
--gui |
啟動 Web UI 而非命令列 |
| 語言 | 程式碼 |
|---|---|
| 簡體中文 | zh-CN |
| 繁體中文 | zh-TW |
| 英語 | en |
| 日語 | ja |
| 韓語 | ko |
| 法語 | fr |
| 德語 | de |
| 西班牙語 | es |
| 俄語 | ru |
| 阿拉伯語 | ar |
翻譯完成後在當前(或指定)目錄生成:
xxx.zh-CN.mono.pdf — 純中文譯文xxx.zh-CN.dual.pdf — 中英雙語對照(推薦閱讀用)xxx.zh-CN.glossary.csv — 自動提取的術語表推薦使用 dual.pdf,可以同時對照原文和譯文看。
7w4.net小蔥技能站,你的AI助手技能庫。
WARNING 類資訊一般不影響翻譯結果:Expecting ',' delimiter 和 Expecting property name 等警告來自免費翻譯引擎的 JSON 解析問題,工具會自動 fallback 重試,只要最終顯示 "Translation completed" 即為成功。
翻譯質量不佳:切換翻譯服務,推薦 --openai 或 --deepseek 獲得更好的翻譯質量。
記憶體不足:大檔案翻譯峰值記憶體可能超過 1.3GB,用 --pages 分批翻譯。
命令找不到:用 uv 安裝後二進位制可能不在 PATH 中,使用完整路徑呼叫。
scripts/translate_pdf.sh — 一鍵翻譯指令碼:
# 預設英→中
bash scripts/translate_pdf.sh input.pdf
# 指定語言和頁面
bash scripts/translate_pdf.sh input.pdf en 1-10 /output/dir
這個翻譯 Skill 做得相當不錯,文件寫得很詳細,功能也很實用。它支援多種翻譯引擎,預設不用申請 API key 就能用,翻譯出來的 PDF 還能保留原文和譯文的對照,閱讀起來很方便。不過使用時需要先安裝工具,對新手來說可能稍微麻煩一點,另外文件裡缺少效果圖,沒法一眼看出翻譯質量到底怎麼樣。總體來說是一個值得一試的翻譯工具。