SkillHub

pdf-to-image-preview

v0.1.0

将PDF文件的每一页转换为图片文件；支持自定义图片格式（PNG/JPG）和分辨率；适用于文档处理、图片化存档等场景

Sourced from ClawHub, Authored by 无处不在

Installation

Please help me install the skill `pdf-to-image-preview` from SkillHub official store. npx skills add wuchubuzai2018/pdf-to-image-preview

PDF转图片Skill

任务目标

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

前置准备

  • 依赖说明：scripts脚本所需的依赖包及版本 pymupdf>=1.23.0

操作步骤

  • 标准流程：

  • 准备PDF文件

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

  • 执行转换

    • 调用脚本将PDF文件的每一页转换为图片
    • 命令示例： bash 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）

  • 查看输出

    • 图片文件保存在指定的输出目录中
    • 文件命名格式：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