PDF 本地工具箱

要解决什么问题

日常处理 PDF 时，合并扫描件、按章节拆页、纠正横竖版、批量打水印、从文档里抠出嵌入图，或把漫画/相册 PDF 做成翻页预览，往往要在多个桌面工具之间切换，还容易把文件上传到第三方服务。若你希望在本地、不经过大模型完成这些操作，就需要一套命令清晰、依赖可分的工具链。

核心能力与实现思路

本技能把能力拆成独立子命令，按任务选 Ghostscript 或 PyMuPDF，尽量走系统侧已有组件：

• merge / split / images：合并多文件、按页码范围拆页、提取 PDF 内嵌入的原始图片，主要依赖 Ghostscript（文档称系统已安装）。
• extract / jpg / rotate / watermark：按页提取文字、将指定页渲染为 JPG、90°/180°/270° 旋转、文字或图片水印，走 PyMuPDF；页码范围用 -p（如 1-3,5,7-9），渲染类命令可配 --dpi、JPG 的 -q。
• video / gif：把每页当作一帧，按 -s 控制每页停留秒数；video 合成 MP4（需 moviepy），服务器装不了 ffmpeg/moviepy 时用 gif（PyMuPDF + Pillow）作降级，体积更大但行为类似。

设计上强调本地优先：能由 Ghostscript 完成的合并/拆图不额外占 token；旋转与水印在同一库内改页面，可与拆分分步组合完成。

适用边界与注意点

• images 与 jpg 不同：前者是内嵌位图，后者是整页 raster 截图。
• 不支持干净去水印、不支持 PDF 转 Word（文档建议 LibreOffice / pandoc）。
• 旋转后再加水印需分两步；若要把全书拆成单页文件，需 PyMuPDF，否则用 -p 指定范围。
• 翻页 GIF 适合预览或小页数；长漫画 MP4 对内存与 moviepy 体积更敏感，可按环境选 gif 降级。