前言¶
日常開發或辦公里，PDF 往往卡在「要改一頁文字」「掃描件要 OCR」「要拆成幾份或轉成 Word/圖片」這類操作上。常見做法是單獨開桌面軟件或寫腳本調庫，和當前對話、代碼上下文是割裂的。下面介紹 SkillHub 上的 PDF EDITOR（座標 @user_09701b7c/mainpdf）：把它裝進 Cursor、Claude Code 等支持 Skills 的 Agent 後，可以用自然語言觸發編輯、轉換、提取和總結，且官方標註 requires_api_key=false，不依賴額外 API Key。
這是什麼¶
PDF EDITOR 是社區來源（community）的辦公效率類 Skill，分類爲 office-efficiency，當前版本 v1.0.1，由發佈者 user_09701b7c 維護。SkillHub 頁面將其定位爲「全能 PDF 編輯器」：面向掃描件與普通 PDF，覆蓋文字/表格/圖片提取、OCR、插入編輯、格式轉換（Word/圖片/HTML）以及文檔總結歸納。實現形態遵循通用 SKILL.md 格式，由 Agent 在匹配到相關意圖時加載技能說明並執行對應流程。
官方入口：
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_09701b7c/mainpdf
- 技能座標 API 頁：https://api.skillhub.cn/user_09701b7c/mainpdf
核心功能¶
以下能力均來自 SkillHub 簡介與 Trigger 說明，未在資料中出現的細節不展開。
編輯與結構¶
- PDF 編輯、合併（PDF 合併 / pdf merge）、拆分（PDF 拆分 / pdf split）
- 在 PDF 中插入文字、插入圖片
提取與識別¶
- 提取 PDF 文字、提取 PDF 表格
- 從掃描件與普通 PDF 中提取文字、表格、圖片
- PDF OCR、掃描件識別
格式轉換¶
- PDF 轉 Word（pdf to word / PDF轉Word）
- PDF 轉圖片（pdf to image / PDF轉圖片）
- 另支持轉換爲 HTML（簡介中寫明）
理解與歸納¶
- PDF 總結：對文檔內容做總結歸納
觸發關鍵詞¶
Agent 在對話中出現下列一類表述時，可據此掛載本 Skill（節選，與官方 Trigger 一致）：PDF編輯、PDF轉換、PDF提取、PDF OCR、掃描件識別、提取PDF文字、提取PDF表格、PDF插入文字、PDF插入圖片、PDF總結、pdf editor 等。
安裝與啓用¶
安裝方式以 SkillHub 通用文檔爲準；技能頁也提示：讓 AI 根據 https://skillhub.cn/install/skillhub.md 安裝 @user_09701b7c/mainpdf。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可用官方腳本完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝 PDF EDITOR 到當前 Agent 的 skills 目錄¶
官方要求：必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。
在 Cursor 中，常用路徑爲 ~/.cursor/skills/：
skillhub install user_09701b7c/mainpdf --dir ~/.cursor/skills/
其他客戶端路徑（摘自 SkillHub 安裝文檔，按你實際使用的環境選擇）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/ - Gemini CLI：
~/.gemini/skills/
安裝後按各客戶端要求重啓或刷新 Agent，使新 Skill 生效。
3、對話式安裝（可選）¶
若已在使用支持讀 URL 的 Agent，也可直接發送官方頁給出的提示，例如：請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_09701b7c/mainpdf。效果等價於讓 Agent 按同一套流程拉取並落到正確的 skills 目錄。
典型用法¶
公開頁未提供單獨的命令行子工具說明；本 Skill 的典型用法是 在 Agent 對話中說明目標和文件，由技能指引 Agent 完成處理。下列表述與官方 Trigger 對齊，便於復現「何時會啓用本 Skill」：
- 「把這份掃描 PDF 做 OCR，提取文字。」
- 「把這個 PDF 拆成按章節命名的多個文件。」
- 「PDF 轉 Word，保留表格儘量可編輯。」
- 「從 PDF 裏提取表格並總結全文要點。」
- 「合併目錄下這幾個 PDF，並在某一頁插入一張圖片。」
具體依賴本地工具鏈或技能內腳本的步驟，以安裝後 SKILL.md 中的說明爲準；本文不編造未公開的參數或接口名。
適用場景與注意¶
適合誰
- 經常在 IDE / 終端裏用 Agent 處理文檔，希望 PDF 操作與當前任務同一上下文完成。
- 需要 OCR、合併拆分、轉 Word/圖片/HTML、提取與總結等組合能力，且希望用中文或英文混合關鍵詞觸發。
使用上需注意
- 評分與下載量以 SkillHub 頁面實時數據爲準（抓取時：評分 100000，下載 3520，版本 1.0.1）。
- 社區 Skill，行爲與依賴以技能包內文檔爲準；大文件、複雜版式或加密 PDF 的實際效果需在本地驗證。
- 安裝路徑錯誤是常見坑：務必
--dir指向當前 Agent 的 skills 目錄。
結尾¶
PDF EDITOR 把 PDF 編輯、轉換、提取、OCR 和總結收斂到 Agent Skills 一條鏈路上，適合辦公效率場景下減少切換工具。安裝與座標以 SkillHub 爲準：
- https://www.skillhub.cn/skills/user_09701b7c/mainpdf
- https://api.skillhub.cn/user_09701b7c/mainpdf
