带章PDF转图片

问题：PDF 转图这件事，并没有看起来那么简单

把一份 PDF 变成图片，工具遍地都是，但真正用过就会发现坑不少：合同转成 JPG 后公章不见了；第 3 页截出来当封面，图是糊的；备案材料拼成长图超过 10MB，微信传不上；手头的扫描件、加密文件、几百页的大文件，很多脚本跑一半就报错退出。

这个技能解决的就是这一类具体问题：任何「把 PDF 变成图片」的需求，并且把最容易翻车的公章保留做成了默认行为，而不是附加选项。

核心能力

基于 PyMuPDF 渲染，全程只用 Python（pymupdf + pypdf + Pillow），Windows / macOS / Linux 命令完全一致，没有系统独占依赖，不需要 Adobe，不联网。

• 整份转图：每一页渲染成一张图，36 页就出 36 张，命名为 page_001.png 这样的三位补零格式
• 截页与拼接：start end 指定连续页；--pages "1,3,5-8" 挑任意页；--stitch 拼成一张长图，可加 --margin 控制页间距
• 公章保留与自动修复：PyMuPDF 默认渲染就包含数字签名域外观；万一渲染器没画出来，入口脚本会检测「页面有签名域但图上无章」，改用 annots=False 渲染干净底图、提取印章位图合成回去——这条路径跨平台生效，Windows 用户同样能自动补章，不依赖 macOS 的 Quartz
• 输出可控：单页可输出 png / jpg / webp（WebP 由 Pillow 兜底），拼接输出固定 JPG；拼接超过 10MB 自动警告，降 --quality 即可压缩
• 附带的自检：自动提示疑似空白页；页码输错自动修正；文件不存在、损坏、加密时给出明确的修复指引，不会直接崩溃

怎么用

把 PDF 路径交给 AI，说人话即可。AI 会识别页数、选对脚本和参数。开发者也可以手动跑命令行，pdf_to_image.py 是一站式入口，render_with_mupdf.py 和 stitch.py 是底层单步脚本，用法三平台一致。

转图模糊就提高 dpi 到 200~300（DPI 越高文件越大，微信传图建议 150~200）。

边界与注意点

这个工具只做「PDF → 图片」，不做 OCR、不做 PDF 编辑、不破解加密文件、不联网。

• 加密 PDF：需要密码才能打开，需向文件提供方索取；工具不破解
• 损坏的 PDF：用 WPS 或预览打开后另存一份再转
• 超大 PDF（1000+ 页）：渲染慢、占内存，只转需要的页，或分批处理
• 扫描件：转出的图就是扫描内容本身，无法「变清晰」，只能提高 DPI
• 非红色或极浅的印章：自动补章后颜色变化可能不明显，属正常现象

安全方面，所有脚本完全本地运行，源 PDF 永远只读不改，单页图按页码命名不会互相覆盖，不发送日志、不调用任何外部 API。