长图转 PDF

要解决什么问题

聊天长截图、整页网页抓取图这类单文件超长位图，直接塞进 PDF 往往一页拉得很长，打印和阅读都不友好；整图缩放又会糊掉细节。你需要的是：在尽量不损失可读性的前提下，把长图切成多段，再按固定版式拼进 PDF。

技能如何工作

技能通过命令行执行 scripts/slice_and_pdf.py，依赖 Pillow 与 reportlab 完成读图、切片与排版。

• --source：源长图路径（建议绝对路径）
• --out-dir：输出 PDF 目录
• --slice-height / --overlap：按像素高度切分，相邻切片可设重叠，减轻接缝处内容被截断
• --cols / --rows / --layout：控制 PDF 每页上的切片数量与排列方式，grid 为从左到右，column 为自上而下
• --pdf-name：输出文件名（默认 output.pdf）
• --cleanup：生成 PDF 后删除中间切片，省磁盘（代理侧通常默认开启，除非你明确要保留切片）

执行成功后以终端 STDOUT 中的 STATUS: Success 为准，向用户说明 PDF 保存路径即可。

适用边界与注意点

• 面向视觉型长图转 PDF，不是 OCR 或文本提取流程。
• 不要用 cat、文本读取等方式去「验证」生成的 PDF 内容；二进制 PDF 应由用户本地打开查看。
• 切片高度、行列数与重叠需要按原图比例和内容密度调整；默认 2×2 网格适合多数截图，极窄长条图可改为单列多行（column）。