前言¶
处理 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