pdf-to-image-preview

name	pdf-to-image-preview
description	将PDF文件的每一页转换为图片文件；支持自定义图片格式（PNG/JPG）和分辨率；适用于文档处理、图片化存档等场景
dependency	{"python":["pymupdf>=1.23.0"]}

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