前言¶

處理 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