前言¶

處理一批掃描件時，常見做法是「整份 PDF 一律送 OCR」。後果是：那些本來帶文本層的頁面被反覆重識別，耗時長、成本高；或者反過來，文本層殘缺的頁面被當作文本頁直接抽取，字段丟掉。

PDF Inspector 就是爲這個問題設計的：先讀 PDF 的內部結構，逐頁判斷這一頁是文本型、還是需要 OCR。它由社區開發者 user_1a99cb00 發佈在 SkillHub，分類 office-efficiency，版本 1.0.0。

它是什麼¶

一句話定位：一個用 Rust 寫的 PDF 路由工具（router），輸入一份 PDF，輸出逐頁的處置結論——文本型直接抽取，圖像型才走 OCR。

它不負責 OCR 本身，也不負責最終的內容提取，只做「該走哪條路」這一步。

發佈方：user_1a99cb00（community 來源，非官方團隊維護）。頁面標註的熱度爲 1.9M views、8.1K stars，評分 100000，下載 2027。

核心功能¶

1、讀取 PDF 內部結構，而非只看文件後綴或文件大小。

2、按頁（per-page）給出判斷，不是整份 PDF 一個結論。一份混合文檔裏，前半是文本、後半是掃描頁的情況很常見。

3、判定結果分兩類：文本型（可直接抽取文本）或需要 OCR（內容在圖像裏，必須走識別）。

4、實現語言爲 Rust，解析邏輯在本地完成，頁面標註不需要 API Key（requires_api_key=false）。

5、座標 @user_1a99cb00/pdf-inspector，分類 office-efficiency。

安裝與啓用¶

已抓取資料中沒有給出安裝命令、依賴清單或配置文件字段，這裏不做推測。官方地址如下：

https://api.skillhub.cn/user_1a99cb00/pdf-inspector

SkillHub 頁面：

https://www.skillhub.cn/skills/user_1a99cb00/pdf-inspector

這類 Skill 基於通用 SKILL.md 格式，裝進 Agent 的 Skill 目錄後即可被調用；具體目錄位置和啓用方式請以 SkillHub 頁面的說明爲準（本次抓取未拿到該頁正文）。

需要說明的是，資料裏沒有區分 Cursor / Codex CLI / Claude Code 的安裝差異，因此這裏不給差異說明，避免寫出未經覈實的命令。

典型用法¶

資料中只給出了定位和能力描述，沒有附帶可復現的命令行示例或調用參數。下面這段是與其定位一致的調用意圖，參數名以官方說明爲準：

輸入：一份混合型 PDF（部分頁帶文本層，部分頁是掃描圖像）

過程：逐頁讀取內部結構

輸出：每頁的判定結論 —— 文本型 / 需要 OCR

依據判定分流：文本型頁直接抽取文本，需要 OCR 的頁送 OCR 流程

需要留意的是，這個 Skill 只產出路由結論，後面的文本抽取和 OCR 識別要由調用方自己接。

適用場景與注意¶

適合的場景：

1、掃描件和電子稿混在一起的文檔庫，想按頁分流處理。
2、想省 OCR 開銷，把文本層完好的頁面排除在識別流程之外。
3、批量處理前先摸清楚文檔構成，再決定識別策略。

限制和坑：

1、版本 1.0.0，社區發佈，功能邊界和後續維護情況未知。
2、頁面標註的分類是 office-efficiency，屬於效率工具類，不是 OCR 引擎本身。
3、評分 100000、下載 2027 是頁面當前顯示的數據，會隨時間變化。
4、OCR 能力不在 Skill 內，識別結果的準確率取決於你接的 OCR 服務。

小結¶

PDF Inspector 的價值在於把「該不該 OCR」的判斷提前到處理流程之前，逐頁給出結論，避免整份文檔一刀切。如果你手上的文檔來源混雜，它可以先把文本頁篩出來。

官方地址：https://api.skillhub.cn/user_1a99cb00/pdf-inspector