前言¶

处理 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 简介为准，官方列出的能力是：

1. 合并：多个 PDF 合并成一个。
2. 拆分：把一份 PDF 拆开。
3. 压缩：减小文件体积，便于邮件发送。
4. 转 Word：把 PDF 内容转成可编辑文档。
5. 提取页面：只保留指定页码，导出成新文件。
6. 加页码水印：在页面上叠加页码或水印。

上游 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      # 示例文件

实际使用建议按这个顺序走：

1. 先用 examples/sample.pdf 跑一遍，确认脚本在你本地能执行、依赖能装上。
2. 再拿两三份真实的 PDF 试合并或拆分，核对输出文件的页码和顺序是否正确。
3. 确认无误后再接到批量脚本上，一次处理整个文件夹。

适用场景与注意¶

适合的场景：行政做合同和报表的合并归档，财务处理发票和流水扫描件的压缩与拆分，学生把讲义和论文按章节提取，法务把长文档按页切分后分别送审。这些都是重复性强、格式要求稳定、对页码顺序敏感的任务，交给脚本处理比手工点击更可靠。

需要注意的几点：

1. 转 Word 和加页码水印这两项只在 SkillHub 简介里出现，上游功能清单和文件结构中都没有对应的脚本或说明，选它之前先确认是否真的支持。
2. 上游功能清单里的 PDF 转图片只提到 PNG 和 JPG，没有提到转 Word 或转 Excel。
3. 页码顺序是这类工具最容易出错的地方。合并前确认文件排序符合预期，拆分时用 -p 明确指定范围，避免整份文件被静默丢掉。
4. 压缩对扫描件和纯文字文件的生效程度差别很大，配置里的 quality 是 medium 时先看输出体积，再决定是否需要更激进的设置。
5. 批量处理是覆盖式操作，输出目录建议单独建一个，不要和输入文件夹混在一起。
6. 许可证是 MIT-0，可以用于内部流程，对外分发时注意条款要求。
7. 上游页面列出了基础版 ¥99（合并、分割、压缩）和专业版 ¥199（加 PDF 转图片、批量处理、API 接口）两档价格。这是上游 ClawHub 页面写的内容，SkillHub 侧没有价格信息，是否仍然有效需要自行向发布者确认。
8. 上游页面标注的更新时间是 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