前言¶
处理 PDF 的常规做法是装一个桌面工具，或者写一段脚本自己调库。前者要手动点界面、一批文件点几十次，后者要自己处理页面范围、输出目录、文件名冲突。当这件事要放进 Agent 工作流里反复执行时，这两个办法都不够省心。
下面介绍 PDF Toolkit Pro。它是一个把 PDF 批量处理动作固化成脚本和操作说明的 Skill，覆盖合并、拆分、压缩、转换、提取页面、加页码水印这几类日常需求。你只需要告诉它「要做什么 + 文件在哪」，它给出可执行的命令和需要注意的地方。
这是什么¶
PDF Toolkit Pro 是一个面向办公文档场景的 PDF 批量处理技能包，定位是把常见的 PDF 操作封装成一组脚本加一份 SKILL.md 说明，让 Agent 能按步骤完成合并、分割、压缩、转换。
- SkillHub 上的名称：PDF Toolkit Pro，坐标
@clawhub_gdp6539/pdf-toolkit-pro - SkillHub 页面：https://www.skillhub.cn/skills/clawhub_gdp6539/pdf-toolkit-pro
- 发布者：gdp6539，来源标注为 clawhub，上游仓库 https://clawhub.ai/gdp6539/pdf-toolkit-pro
- 版本 1.0.0，许可证 MIT-0，分类 office-efficiency
- 不需要 API Key（标签
requires_api_key=false） - SkillHub 侧数据：评分 100000，下载 21548，安装 172。任务线索里写的「下载 1391 次」与该数据不一致，以 SkillHub 页面为准。
它的简介在两个来源里措辞不同，这里都列出来，避免后续核对时产生混淆：
- SkillHub 版简介：PDF 合并、拆分、压缩、转 Word、提取页面、加页码水印，适合行政、财务、学生、法务。
- 上游 ClawHub 版简介：PDF 批量处理技能包，一键合并、分割、压缩、转换 PDF，适合办公人员、文档处理、自动化工作流。
两个版本对得上的是合并、分割、压缩、提取页面；转 Word 和加页码水印只出现在 SkillHub 版简介里，上游功能清单中没有这两项，属于需要进一步核实的能力。
核心功能¶
以 SkillHub 简介为准，官方列出的能力是：
- 合并：多个 PDF 合并成一个。
- 拆分：把一份 PDF 拆开。
- 压缩：减小文件体积，便于邮件发送。
- 转 Word：把 PDF 内容转成可编辑文档。
- 提取页面：只保留指定页码，导出成新文件。
- 加页码水印：在页面上叠加页码或水印。
上游 ClawHub 页面的功能清单略有差异，它把能力写成合并、分割、提取指定页面、压缩、PDF 转图片（PNG/JPG）、批量处理整个文件夹、自定义配置（页面范围、质量、格式）。也就是说上游额外强调批量处理和转图片，而 SkillHub 版额外强调转 Word 和水印。
共同点是同一套骨架：确定操作类型、确定输入文件、确定输出位置。差别在于具体支持哪些操作，选型时建议按你最常用的那一两种操作去核对。
安装与启用¶
SkillHub 侧没有给出独立的安装命令。能核实到的安装方式来自上游 ClawHub 页面。
ClawHub 页面给出两条入口，一条是 CLI，一条是 npx：
# CLI 方式
openclaw skills install @gdp6539/pdf-toolkit-pro
# npx 方式
npx skills
页面把 npx skills 列在 Install 一栏，具体参数没有展开说明，所以这里只原样列出，不补全命令行参数。
安装完成后，需要在 Agent 侧确认这个 Skill 被加载。它基于通用 SKILL.md 格式，加载方式取决于你用的是哪个 Agent 客户端，官方资料里没有分别说明 Cursor、Codex CLI、Claude Code 的差异，这部分无法核实，就不写推测。
另外需要 API Key 这一项是不需要的，标签里写的是 requires_api_key=false，所以启用前不需要准备密钥。
典型用法¶
上游 ClawHub 页面给了一组命令行示例，文件结构是 scripts/ 下放若干脚本，templates/config.json 放配置模板。这些命令来自上游仓库 README，SkillHub 侧没有重复给出，实际执行前建议先确认脚本路径和参数在你本地的版本里成立。
合并：
node scripts/merge.js input/*.pdf -o output/merged.pdf
分割并提取指定页面：
node scripts/split.js input.pdf -p 1-5 -o output/
压缩：
node scripts/compress.js input.pdf -o output/compressed.pdf
转图片：
node scripts/to-image.js input.pdf -o output/images/
批量处理整个文件夹：
node scripts/batch.js input/ -o output/ --operation merge
上面这几条命令的用法是一致的：-o 指定输出位置，-p 指定页面范围，--operation 指定批量操作类型。
上游给的配置示例是这样的，用于批量场景下统一指定操作列表、输出格式、质量、页面范围、图片格式和 DPI：
{
"operations": ["merge", "compress"],
"outputFormat": "pdf",
"quality": "medium",
"pageRange": "all",
"imageFormat": "png",
"imageDPI": 150
}
文件结构如下：
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 # 示例文件
实际使用建议按这个顺序走：
- 先用
examples/sample.pdf跑一遍，确认脚本在你本地能执行、依赖能装上。 - 再拿两三份真实的 PDF 试合并或拆分，核对输出文件的页码和顺序是否正确。
- 确认无误后再接到批量脚本上，一次处理整个文件夹。
适用场景与注意¶
适合的场景：行政做合同和报表的合并归档，财务处理发票和流水扫描件的压缩与拆分，学生把讲义和论文按章节提取，法务把长文档按页切分后分别送审。这些都是重复性强、格式要求稳定、对页码顺序敏感的任务，交给脚本处理比手工点击更可靠。
需要注意的几点：
- 转 Word 和加页码水印这两项只在 SkillHub 简介里出现，上游功能清单和文件结构中都没有对应的脚本或说明，选它之前先确认是否真的支持。
- 上游功能清单里的 PDF 转图片只提到 PNG 和 JPG，没有提到转 Word 或转 Excel。
- 页码顺序是这类工具最容易出错的地方。合并前确认文件排序符合预期，拆分时用
-p明确指定范围，避免整份文件被静默丢掉。 - 压缩对扫描件和纯文字文件的生效程度差别很大，配置里的
quality是 medium 时先看输出体积，再决定是否需要更激进的设置。 - 批量处理是覆盖式操作，输出目录建议单独建一个，不要和输入文件夹混在一起。
- 许可证是 MIT-0，可以用于内部流程，对外分发时注意条款要求。
- 上游页面列出了基础版 ¥99（合并、分割、压缩）和专业版 ¥199（加 PDF 转图片、批量处理、API 接口）两档价格。这是上游 ClawHub 页面写的内容，SkillHub 侧没有价格信息，是否仍然有效需要自行向发布者确认。
- 上游页面标注的更新时间是 5 个月前，版本仍是 1.0.0，批量脚本的行为可能在长期使用中有边界情况。
结尾¶
PDF Toolkit Pro 的价值在于把 PDF 的常见操作变成一组可以复现的命令和配置，让 Agent 在接到「把这几份合并一下」「只要第 3 到第 10 页」这类请求时，能直接给出可执行步骤而不是泛泛的回答。对行政、财务、学生和法务这几类文档密集的日常场景比较实用。
官方地址：https://api.skillhub.cn/kunlungrowth/pdf-toolkit-pro
上游仓库：https://clawhub.ai/gdp6539/pdf-toolkit-pro
