用途:翻译 PDF 文档并生成排版精美的中文文档,输出 Markdown 与 PDF 双格式。当前版本 v4.0.0,发布日期 2026-02-21。
主要能力:v4.0.0 采用 Markdown-first 工作流,先生成结构化 Markdown 再转 PDF;PDF 引擎从 reportlab 切换为 weasyprint,支持完整 HTML/CSS 排版;修复代码块中文乱码(添加 CJK 字体 fallback);支持标题层级、代码块、表格、列表、引用、粗体斜体;新增 scripts/md2pdf.py 通用转换脚本。PDF 排版含 A4 版面、自动分页、页码,中英文字体 fallback,深色背景代码块,专业表格样式,蓝色左边框引用块。
使用方式:先用 pdfplumber 提取 PDF 文本,长文档(>20 页)先提取前几页了解结构再分批提取;通读全文识别标题、章节、目录、代码块、表格、列表、引用等元素并映射到 Markdown;逐章节翻译,每完成一章追加写入文件;写入与原 PDF 同目录的“原文件名_中文翻译.md”;再用 python3 ${SKILL_DIR}/scripts/md2pdf.py "输入.md" "输出.pdf" 生成 PDF。macOS 报 gobject 找不到时用 DYLD_FALLBACK_LIBRARY_PATH="/opt/homebrew/lib" python3 ${SKILL_DIR}/scripts/md2pdf.py "输入.md" "输出.pdf"。
翻译规则:专有名词保留英文并在首次出现时括号附英文;代码块与行内代码不翻译;保持 #→#### 层级不跳级;块级元素前后留空行。
依赖安装:macOS 用 brew install pango;pip3 install pdfplumber markdown weasyprint。旧方案依赖 pip3 install reportlab pypdf。
限制与注意:必须逐章节翻译,避免一次性输出导致截断;注意段落、列表、表格、代码块、标题前后空行,否则格式不渲染;中文字体不显示需确认系统有苹方或黑体。更多参考见 translation-standards.md、字体配置、troubleshooting.md。价格与平台支持资料暂未提供。