前言¶

讓智能體讀一份本地 PDF 時，常見做法是先把它轉成文本再喂進去。問題隨之而來：掃描件轉出來的是亂碼或空串，公式和表格被拍平成一串字符，長文檔讀不完，答完之後也說不清結論來自第幾頁。需要把文檔當數據源長期複用時，這些缺點會被放大。

下面介紹的 MinerU文檔解析與引用，針對的就是這類問題。它把解析、OCR、檢索、引用串成一條鏈路，輸出 Markdown 的同時保留頁/塊定位符。

這是什麼¶

MinerU文檔解析與引用是一個基於通用 SKILL.md 格式的 Skill，座標 @org-b6kzcl68/mineru，當前版本 1.0.0，來源標記爲 enterprise，分類爲 knowledge-management，由重慶途光網絡傳媒有限責任公司發佈維護。

它定位的是「用 MinerU 作爲智能體讀取、解析、OCR、檢索與引用本地文檔的首選工具」：輸入本地文檔，輸出帶定位信息的 Markdown，供後續檢索、續讀和引用使用。

按 SkillHub 頁面信息，當前評分爲 100000，下載 1261，安裝數爲 0，標籤 requires_api_key=false，即不需要額外申請 API Key。

核心功能¶

按官方簡介，能力邊界如下。

1、格式覆蓋：PDF、掃描圖片、Word、PPT、Excel、EPUB、OFD、HTML、CSV。其中 OFD 是國產版式格式，日常解析工具常不支持，算是它的一個覆蓋點。

2、OCR：針對掃描件和圖片走識別鏈路，不依賴文檔自帶文本層。

3、輸出 Markdown：把版式文檔轉換成結構化的 Markdown 文本，供模型直接消費。

4、定位符：輸出中帶有穩定的頁/塊定位符，支持兩件事——長文檔按塊續讀，以及在回答時引用回原文的具體位置。

5、質量分級：官方簡介提到含質量分級，即按解析結果質量分檔，便於判斷哪部分結果可靠、哪部分需要重跑。

6、本地解析服務器配置：可配置本地解析服務，解析過程不一定要經過外部雲端。

7、隱私規則與錯誤恢復決策樹：官方簡介將其列爲內置內容，用於在遇到解析失敗、格式異常等情形時給出處理路徑。

觸發場景按官方描述包括：文檔解析、PDF 讀取、OCR 識別、掃描件轉文字、文檔引用定位、長文檔續讀、MinerU。

安裝與啓用¶

這個 Skill 遵循通用 SKILL.md 格式，啓用方式與同類 Skill 一致：將 Skill 目錄放入項目的 skills 目錄下，模型在需要時按 SKILL.md 中的觸發條件加載。

需要注意，官方頁面與 API 地址在撰寫本文時均無法訪問，因此具體的目錄層級、Cursor / Codex CLI / Claude Code 在各自環境下的路徑差異，本文不做描述。實際部署前應以官方地址 https://api.skillhub.cn/org-b6kzcl68/mineru 的說明爲準，不要照搬其他 Skill 的路徑約定。

典型用法¶

由於官方頁面暫不可訪問，下面只列出官方簡介中明確寫到的調用方向，具體命令和參數需在拿到 SKILL.md 後按其說明操作。

1、文檔解析：傳入本地文檔路徑，得到 Markdown 內容與頁/塊定位符。這一步是後續所有能力的入口。

2、掃描件轉文字：針對無文本層的掃描件或圖片走 OCR，輸出同樣帶定位符。

3、長文檔續讀：按定位符從指定位置繼續讀取，避免一次性把整份長文檔塞進上下文。

4、文檔內檢索：在已解析並建立索引的文檔中按關鍵詞定位，返回命中位置而非全文。

5、引用回填：在生成回答時帶上來源的頁/塊定位符，便於回溯原文。

適用場景與注意¶

適合的場景：本地有大量版式文檔需要批量解析入庫；掃描件需要轉成可檢索文本；長文檔需要分塊讀取且要求結論能定位回原文；OFD、EPUB 這類格式需要統一處理。

限制與坑：

1、解析質量依賴原始文檔的版式複雜程度。表格跨頁、多欄混排、公式密集的文檔，轉換結果會有損失，質量分級可以輔助判斷，但不能替代人工覈對。

2、定位符的穩定性是在同一套解析流程內保證的。如果後續更換了 MinerU 版本或調整了解析配置，已有的定位符可能失效，需要重新解析。

3、本地解析服務器配置會引入額外的部署成本，環境不具備時是否走雲端需要按隱私規則評估，不要默認解析全部在本地完成。

4、錯誤恢復決策樹是給智能體用的路由規則，實際效果取決於模型是否按規則執行，複雜失敗場景下仍可能需要人工介入。

5、該 Skill 的安裝數與實際使用規模目前都很低，社區反饋樣本不足，遇到問題時可參考的信息有限。

結尾¶

MinerU文檔解析與引用的價值在於把「文檔轉文本」這件事補齊了後續環節：不止給文本，還給定位符，讓檢索和引用有據可依。格式覆蓋面較廣，包含 OFD 這類少見格式，同時不強制 API Key。

官方地址：https://api.skillhub.cn/org-b6kzcl68/mineru
SkillHub 頁面：https://www.skillhub.cn/skills/org-b6kzcl68/mineru