- name
- pdf-to-image-preview
- description
- 将PDF文件的每一页转换为图片文件；支持自定义图片格式（PNG/JPG）和分辨率；适用于文档处理、图片化存档等场景
- dependency
- python
PDF转图片Skill
任务目标
- 本Skill用于：将PDF文件的每一页转换为独立的图片文件
- 能力包含：PDF文件解析、图片格式转换（PNG/JPG）、可调分辨率输出
- 触发条件：用户需要将PDF转换为图片、提取PDF页面、图片化PDF内容等场景
前置准备
- 依赖说明：scripts脚本所需的依赖包及版本
pymupdf>=1.23.0操作步骤
- 标准流程：
1. 准备PDF文件 - 确认PDF文件路径（使用 ./ 表示当前工作目录） - 例如：./document.pdf
2. 执行转换 - 调用脚本将PDF文件的每一页转换为图片 - 命令示例：
python scripts/convert_pdf_to_images.py \
--input ./document.pdf \
--output-dir ./images- 可选参数： - --image-format: 图片格式，支持 png 或 jpg，默认为 png - --dpi: 图片分辨率（DPI），默认为 200 - --zip: 生成ZIP压缩包 - --zip-output: ZIP压缩包输出路径（默认：images.zip）
3. 查看输出 - 图片文件保存在指定的输出目录中 - 文件命名格式：page_001.png、page_002.png... - 可选择是否生成ZIP压缩包
资源索引
- 必要脚本：见 scripts/convert_pdf_to_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格式）
python scripts/convert_pdf_to_images.py \
--input ./report.pdf \
--output-dir ./images示例2：使用JPG格式
python scripts/convert_pdf_to_images.py \
--input ./document.pdf \
--output-dir ./images \
--image-format jpg示例3：高分辨率输出
python scripts/convert_pdf_to_images.py \
--input ./document.pdf \
--output-dir ./images \
--dpi 300示例4：生成ZIP压缩包
python scripts/convert_pdf_to_images.py \
--input ./document.pdf \
--output-dir ./images \
--zip \
--zip-output ./images.zip示例5：完整配置
python scripts/convert_pdf_to_images.py \
--input ./report.pdf \
--output-dir ./images \
--image-format jpg \
--dpi 200 \
--zip