PDF全能工具箱

解决的问题：PDF 操作散落在一堆工具里

日常处理 PDF 时，工程师面对的不是"一个工具"，而是一串动作：把合同转成 Word、把扫描件拆成单页图片、给报告批量加水印、给内部文档加权限。这类需求在在线工具站上能覆盖一部分，但往往有单文件大小限制、批量要付费、无法用脚本串进流水线；自己写脚本的话，PyMuPDF、pdfplumber、Pillow 各自只解决一部分，还得额外处理依赖缺失、批量容错、输出目录和加密文件这些边角问题。

这个技能把常见操作收敛到同一个 CLI 入口 scripts/pdf_toolkit.py，单文件与批量（目录 / 通配符）走同一套逻辑。

核心能力：转换与编辑两条主线

• 格式转换：18 种互转方向。PDF → Word / Excel / PPT、Office → PDF、PDF ↔ 图片、PDF → TXT / EPUB，以及 OFD、HTML、CAD 转 PDF 和 OCR 文字识别。
• 编辑处理：30+ 种操作。合并、拆分、删页、调序、旋转、压缩、加密解密、权限设置、水印、页眉页脚与页码、裁剪、改页面尺寸、栅格化、扁平化、修改元数据、修复损坏文件。

工作方式

1. 确认输入路径与目标参数；
2. 按目标操作检查依赖——核心为 PyMuPDF/fitz + pdfplumber + Pillow，python-docx、openpyxl、python-pptx、pytesseract、weasyprint、ezdxf 等按需启用；
3. 调用对应子命令，可用 --output 指定输出目录；
4. 汇总成功 / 失败数量与输出路径，失败原因一并给出。

批量与容错

批量模式下每个文件独立处理，单个文件失败不中断整体任务，最终输出"成功 N 个 / 失败 M 个"的汇总及原因列表；密码保护、文件不存在、依赖缺失、输出目录无写入权限等都有明确的错误提示，而不是抛一个裸 traceback。

适用边界

• 超过 100MB 的 PDF 建议先跑 compress；
• 加密 PDF 在多数操作前需要先 decrypt，encrypt 本身不受影响；
• 扫描件的文字提取与转 Word 需要加 --ocr；
• 中文场景需系统已装中文字体，OCR 需 chi_sim 语言包；
• 默认不覆盖已有文件，强制覆盖要加 --force；
• 复杂排版 PDF 转 Word / Excel 的还原度取决于版面解析与表格识别能力，复杂表格和多栏排版可能丢失部分结构。