mcpField
P
pdf-to-image-preview

pdf-to-image-preview

github.com/wuchubuzai2018文档处理4357 次安装8 周前更新
代码仓库

关于 pdf-to-image-preview

pdf-to-image-preview 是一项将 PDF 每页转换为独立 PNG 或 JPG 图片的 Skill，适用于需要页面预览或图片文件的用户，并支持调整分辨率及可选 ZIP 输出。

主要功能

  1. 01将 PDF 页面转换为 PNG 或 JPG
  2. 02通过 DPI 设置输出分辨率
  3. 03将图片保存到指定目录
  4. 04可选将结果打包为 ZIP
  5. 05支持最多 100 页的 PDF

适用场景

  1. 01创建 PDF 的图片预览
  2. 02提取 PDF 页面为图片文件
  3. 03将文档转换为 JPG 格式
  4. 04将转换后的页面打包为 ZIP

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wuchubuzai2018/expert-skills-hub --skill pdf-to-image-preview

安装后在 Claude Code 中输入/pdf-to-image-preview确认已加载。

附带文件references/usage-guide.mdscripts/convert_pdf_to_images.py

详细介绍

来自项目 README

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压缩包

资源索引

注意事项

  • 输入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

评论

支持 Markdown