前言¶
掃描版 PDF 在 Agent 工作流裏有個常見堵點：頁面上只有圖像，沒有文字層，檢索、引用、二次編輯都靠不上。手工逐頁 OCR 再拼 Markdown，批量教材或資料庫時成本很高。下面介紹 SkillHub 上的社區 Skill「本地ocr識別pdf轉md」，面向批量把掃描 PDF 做成帶文字層的 PDF，並導出 Markdown 或純文本，便於後續檢索與 Agent 消費。
這是什麼¶
「本地ocr識別pdf轉md」是 SkillHub 座標 @user_543d2acf/pdf-ocr-zc 上的 Agent Skill（版本 1.0.0，來源 community，分類 office-efficiency）。發佈者爲 user_543d2acf（SkillHub 頁面標註作者爲 zhangchong）。它解決的是：對掃描 PDF 做批量 OCR，生成帶文字層的 PDF，並可導出爲 Markdown 或純文本。官方簡介中舉例的場景包括：老師類 Agent 需要將大量掃描教材 PDF 轉化爲可檢索文本。標籤 requires_api_key=false，表示按 SkillHub 元數據不需要額外配置 API Key。
SkillHub 頁面：https://www.skillhub.cn/skills/user_543d2acf/pdf-ocr-zc
API 入口（元數據）：https://api.skillhub.cn/user_543d2acf/pdf-ocr-zc
核心功能¶
依據官方簡介與 SkillHub 元數據，可覈實的能力如下：
- 批量 OCR：面向掃描 PDF，而非僅處理單頁。
- 帶文字層的 PDF：OCR 結果寫入 PDF 文字層，便於系統級搜索與複製。
- 導出 Markdown / 純文本：除 PDF 外，可得到便於編輯與餵給大模型的文本形態。
- 本地 OCR 取向：Skill 名稱強調「本地」處理路徑，適合對資料不出本機、或希望減少雲端 OCR 依賴的場景（具體引擎與依賴以安裝後的
SKILL.md爲準）。
公開頁面未單獨列出支持的 PDF 頁數上限、語言列表或排版還原精度，使用前建議在目標樣例上先試一小批。
安裝與啓用¶
Skill 遵循通用 SKILL.md 格式。安裝方式以 SkillHub 官方說明爲準：先具備 skillhub CLI，再用 install 把 Skill 裝進當前 Agent 的 skills 目錄；裝錯目錄時 Agent 不會加載，需要重啓或重新打開會話後纔會識別。
1. 檢查或安裝 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 安裝文檔執行完整安裝（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
說明與優先源策略見：https://skillhub.cn/install/skillhub.md
2. 安裝本 Skill¶
安裝時必須用 --dir 指向當前環境的 skills 目錄。SkillHub 頁面給出的座標爲 @user_543d2acf/pdf-ocr-zc。
skillhub install @user_543d2acf/pdf-ocr-zc --dir <skills 目錄>
常用 Agent 的 skills 路徑（來自 SkillHub 安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中示例：
skillhub install @user_543d2acf/pdf-ocr-zc --dir ~/.cursor/skills/
經過上面的步驟，重啓 Cursor 或新開 Agent 會話後，Skill 應出現在可用技能列表中。公開資料未區分 Codex CLI 與 Claude Code 在本 Skill 上的額外配置差異；若各客戶端行爲不一致，以安裝目錄下該 Skill 的 SKILL.md 爲準。
典型用法¶
公開 SkillHub 頁面未附帶逐步命令行示例；可復現的工作流與官方簡介一致：
- 將待處理的掃描 PDF 放在 Agent 能訪問的路徑（本地項目目錄或你約定的輸入目錄）。
- 在已啓用本 Skill 的 Agent 對話中，說明需要批量 OCR、輸出帶文字層的 PDF，並指明是否同時導出 Markdown 或純文本。
- 按 Agent 引導完成批處理；對教材、講義類資料，可先選 1～2 個文件試跑，確認文字層與 Markdown 結構是否滿足檢索與引用需求，再擴大批量。
若安裝後目錄中存在 SKILL.md，其中的步驟、腳本路徑與參數名應優先於本文概括性描述。
適用場景與注意¶
適合誰
- 需要把掃描教材、掃描講義、歷史歸檔 PDF 變成可檢索文本的開發者或 Agent 搭建者。
- 希望 OCR 在本地側完成、且 SkillHub 標註無需 API Key 的團隊或個人。
使用注意
- 掃描質量、傾斜、雙欄排版會直接影響 OCR 與 Markdown 結構；複雜版式可能需要人工校對。
- 批量任務耗時會隨頁數與機器性能增長，建議分批並保留原始 PDF。
- SkillHub 元數據（抓取時）：評分 100000，下載 4736，安裝 83；數據會隨商店更新變化，以頁面實時顯示爲準。
結尾¶
「本地ocr識別pdf轉md」把掃描 PDF 批量 OCR、文字層 PDF 與 Markdown/純文本導出串成一條 Agent 可用的能力鏈，適合教材與資料庫數字化。安裝與座標以 SkillHub 爲準：
- https://www.skillhub.cn/skills/user_543d2acf/pdf-ocr-zc
- https://api.skillhub.cn/user_543d2acf/pdf-ocr-zc
