PDF Toolkit Pro:把批量 PDF 合并、分割、压缩、转图收敛成几条命令

前言

处理 PDF 的日常是这样的:十几个合同要合成一份,一份两百页的报告只想抽出其中五页,几十兆的扫描件发不进邮件,还需要把每页导成图片逐页看。这些活单独拿出来都不难,难的是它们分散在不同工具里,每次切换都要重新摆弄一遍参数。更麻烦的是批量场景,手工点十次「另存为」就是十分钟。

PDF Toolkit Pro 做的事情就是把这些操作收拢到一个技能包里,用命令行一次跑完。下面介绍它的实际能力、安装方式和可直接复现的用法。

这是什么

PDF Toolkit Pro 是一个 PDF 批量处理技能包,坐标 @clawhub_gdp6539/pdf-toolkit-pro,发布者 gdp6539,开发者署名 AI-Company,当前版本 1.0.0,License 为 MIT-0。

它解决的是上面那几类重复性 PDF 操作:合并、分割、压缩、转图片,并且支持对整个文件夹做批量处理。定位偏向办公自动化工作流,而不是精细的排版编辑。

SkillHub 上收录了同一个包,分类 office-efficiency,标签 requires_api_key=false,评分 100000,下载 21548,安装 172。

需要先说明一点:官方页面(ClawHub)的功能清单只列了合并、分割、压缩、转图片、批量处理这五项,外加自定义配置。任务线索里提到的「创建、编辑、加密」没有在抓取到的官方资料中出现,本文不写这三项。

核心功能

下面这几项都来自上游仓库 README 的功能清单。

1、PDF 合并:多个 PDF 文件合并成 1 个。
2、PDF 分割:按指定页码范围提取页面。
3、PDF 压缩:减小文件体积,用于邮件传输等场景。
4、PDF 转图片:导出为 PNG 或 JPG。
5、批量处理:一次处理整个文件夹。
6、自定义配置:页面范围、压缩质量、输出格式。

从文件结构看,这些能力是真实的脚本实现,不是只靠提示词描述:

pdf-toolkit-pro/
├── SKILL.md          # 技能说明
├── README.md         # 产品文档
├── package.json      # 依赖配置
├── scripts/
│  ├── merge.js       # PDF合并
│  ├── split.js       # PDF分割
│  ├── compress.js    # PDF压缩
│  ├── to-image.js    # PDF转图片
│  └── batch.js       # 批量处理
├── templates/
│  └── config.json    # 配置模板
└── examples/
   └── sample.pdf     # 示例文件

安装与启用

上游 ClawHub 页面给出的安装命令是:

openclaw skills install @gdp6539/pdf-toolkit-pro

这条命令面向 OpenClaw 生态的 skill 安装方式,装完即可在 agent 中调用。

README 里另外给了一段 npm install,但页面上没有写清它对应的包名和前置条件,实际执行前建议先读一下仓库内的 package.json,确认依赖版本和 Node 环境要求。

关于其他编辑器:抓取到的资料中没有提到 Cursor、Codex CLI、Claude Code 的专用安装方式或配置差异,本文不推测。如果这些工具支持通用 SKILL.md 加载,可以按同一份 SKILL.md 接入,但具体路径需要自行验证。

该技能不需要 API Key,标签为 requires_api_key=false。

典型用法

以下是上游 README 中给出的可复现命令。脚本都在 scripts/ 目录下,-o 指定输出位置。

合并多个 PDF:

node scripts/merge.js input/*.pdf -o output/merged.pdf

按页码范围分割,这里是第 1 到第 5 页:

node scripts/split.js input.pdf -p 1-5 -o output/

压缩单个 PDF:

node scripts/compress.js input.pdf -o output/compressed.pdf

转成图片,输出到目录:

node scripts/to-image.js input.pdf -o output/images/

批量处理整个文件夹,--operation 指定操作类型:

node scripts/batch.js input/ -o output/ --operation merge

配置文件放在 templates/config.json,字段包括操作列表、输出格式、压缩质量、页码范围、图片格式和 DPI:

{
  "operations": ["merge", "compress"],
  "outputFormat": "pdf",
  "quality": "medium",
  "pageRange": "all",
  "imageFormat": "png",
  "imageDPI": 150
}

经过上面的步骤,一批 PDF 可以先合并再压缩,或者先分割再转图,中间不需要人工介入。

适用场景与注意

适合谁:日常要处理合同、报告、扫描件的办公人员,需要把 PDF 接入自动化流程的开发者,以及文档管理员和需要批量转图做归档的人。

几点需要注意的:

1、功能边界。这是批量处理工具包,不是 PDF 编辑器。文本修改、表单填写、页面重排这类精细操作不在清单里。如果需求里包含创建或加密,需要先确认实际版本是否支持。
2、压缩效果。README 提到「一键压缩 50%」,这是官方页面的描述,实际压缩率取决于源文件是否已经压缩过、是否含扫描图像。对已经高度压缩的 PDF,收益会明显下降。
3、依赖与环境。脚本依赖 package.json 中的库,安装前应确认 Node 版本。npm install 的具体包名在抓取到的资料中不完整。
4、版本较老。上游页面显示最近更新在 5 个月前,当前版本仍是 1.0.0。接入前建议先看一眼仓库是否有新提交。
5、数据一致性。SkillHub 线索中写的下载量为 1391,而抓取到的资料是 21548,两者不一致,判断流行度时以实际页面为准更稳妥。
6、付费。上游页面列出基础版 ¥99(合并、分割、压缩)与专业版 ¥199(增加 PDF 转图片、批量处理、API 接口)。抓取到的资料没有说明哪些功能在免费安装下可用,购买前需要先确认。

结尾

PDF Toolkit Pro 的价值在于把重复的 PDF 操作变成可重复执行的命令,尤其是批量合并和批量转图这两类手工成本高的场景。它的能力清单清晰、实现是实打实的脚本,不需要 API Key。如果需求正好落在合并、分割、压缩、转图这四件事上,值得装一个试跑;如果需要创建、编辑或加密,先确认版本再决定。

官方地址:https://api.skillhub.cn/zcwl/pdf-toolkit-pro
上游仓库:https://clawhub.ai/gdp6539/pdf-toolkit-pro
SkillHub 页面:https://www.skillhub.cn/skills/clawhub_gdp6539/pdf-toolkit-pro

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜