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