Image2PDF 图片转 PDF

解决什么痛点

日常交付中常见的问题是：一批截图、扫描件或导出图需要合并成 PDF，但顺序不能乱，源图不能被改动，且最终文件要能被工具检查。@user_a808bed4/image2pdf 把转换逻辑收敛到 scripts/images_to_pdf.py，适合需要可重复、可校验的结果，而不是偶尔手工拼版。

技能如何工作

• 确定性转换：脚本接受文件和目录混合输入，按用户给出的文件/目录顺序处理；目录内部按自然文件名排序，因此 2.jpg 会排在 10.jpg 前面。
• 页面策略：默认 --page-size auto，让每张图片获得匹配尺寸的页面；只有需要统一纸张或打印输出时才使用 --page-size a4、letter 或 legal。
• 适配方式：默认 --fit contain；只有在可接受边缘裁剪时使用 fill，只有在明确接受拉伸变形时使用 stretch。
• 图像处理：应用 EXIF orientation，展平透明背景，默认使用 --background white，也可以指定其他 Pillow 颜色；每张图片对应一个 PDF 页。
• 验证：用 pypdf 检查页数和可读 MediaBoxes；涉及纸张尺寸、边距、透明背景或 fill 时，可用 Poppler 渲染代表性页面做视觉确认。
• 运行环境：优先使用 bundled Codex Python runtime，不可用时回落到 python；脚本依赖 Pillow。

适用边界

• 拒绝空输入集合，也拒绝输出路径与输入图片 alias 的情况。
• 不会静默覆盖已有 PDF；只有明确需要替换时才加 --overwrite。
• fill 会裁剪文档边缘，含边距文字的文档不应使用。
• 截图或透明 PNG 默认优先使用浅色背景，除非用户另有指定。
• --recursive 可纳入嵌套目录；--dpi 可控制物理尺寸与栅格分辨率，但不应替代对页面尺寸的显式确认。