python scripts/convert_pdf_to_images.py \
         --input ./document.pdf \
         --output-dir ./images
       

PDF转图片Skill

任务目标

• - 本Skill用于：将PDF文件的每一页转换为独立的图片文件
• 能力包含：PDF文件解析、图片格式转换（PNG/JPG）、可调分辨率输出
• 触发条件：用户需要将PDF转换为图片、提取PDF页面、图片化PDF内容等场景

前置准备

• - 依赖说明：scripts脚本所需的依赖包及版本

pymupdf>=1.23.0

操作步骤

• - 标准流程：

1. 准备PDF文件 - 确认PDF文件路径（使用 ./ 表示当前工作目录） - 例如：./document.pdf

2. 执行转换
- 调用脚本将PDF文件的每一页转换为图片
- 命令示例：
bash
python scripts/convertpdfto_images.py \
--input ./document.pdf \
--output-dir ./images

- 可选参数：
- --image-format: 图片格式，支持 png 或 jpg，默认为 png
- --dpi: 图片分辨率（DPI），默认为 200
- --zip: 生成ZIP压缩包
- --zip-output: ZIP压缩包输出路径（默认：images.zip）

3. 查看输出
- 图片文件保存在指定的输出目录中
- 文件命名格式：page001.png、page002.png...
- 可选择是否生成ZIP压缩包

资源索引

• - 必要脚本：见 scripts/convertpdfto_images.py(用途与参数：PDF转图片脚本)

注意事项

• - 输入PDF文件必须存在且可读
• 输出目录必须具有写入权限
• PDF页数限制：暂支持100页以内的PDF文件，超过100页请拆分后转换
• 大型PDF文件转换可能需要较长时间，请耐心等待

故障排查

• - 脚本找不到错误：确保在Skill目录下执行，或使用相对路径 scripts/xxx.py
• Python版本问题：确保使用Python 3.6或更高版本
• 依赖缺失：执行 pip install pymupdf>=1.23.0 安装依赖
• 页数超限错误：PDF文件超过100页，请使用PDF工具拆分为多个小文件

使用示例

示例1：基本转换（PNG格式）

bash python scripts/convertpdfto_images.py \ --input ./report.pdf \ --output-dir ./images

示例2：使用JPG格式

bash python scripts/convertpdfto_images.py \ --input ./document.pdf \ --output-dir ./images \ --image-format jpg

示例3：高分辨率输出

bash python scripts/convertpdfto_images.py \ --input ./document.pdf \ --output-dir ./images \ --dpi 300

示例4：生成ZIP压缩包

bash python scripts/convertpdfto_images.py \ --input ./document.pdf \ --output-dir ./images \ --zip \ --zip-output ./images.zip

示例5：完整配置

bash python scripts/convertpdfto_images.py \ --input ./report.pdf \ --output-dir ./images \ --image-format jpg \ --dpi 200 \ --zip