前言¶
在 DeepSeek Harness（DSH）裏做檢索、問答或文檔管線時，原始材料往往是 PDF：論文、技術手冊、掃描件。本地只靠通用文本抽取，公式和跨頁表格容易丟結構，長文檔還會撞上遠程解析接口的頁數上限。下面介紹社區插件 dsh-mineru（倉庫 Mu-scorpio/dsh-mineru）：在 Harness 左側提供獨立操作面板，並註冊 Agent 工具，通過 OpenDataLab MinerU v4 接口把 PDF 中的正文、LaTeX 公式、表格和圖表等內容落成 Markdown，並對超長文檔做分片與本地拼接。
這是什麼¶
dsh-mineru 是分類爲 客戶端 的 DSH 插件，維護者爲 Mu-scorpio。package.json 中的描述爲：在 DeepSeek Harness 中提取公式、表格與文本爲 Markdown，並配合智能分片與交互界面（MinerU PDF parsing plugin for DeepSeek Harness (DSH): extract formulas, tables, and text into Markdown with smart chunking and interactive UI.）。
插件按 Cordis 規範拆分爲 Host 引擎與 Web Client 前端；當前發行版本在資料中爲 1.0.0，開源協議爲 MIT。社區目錄頁：https://www.skillhub.cn/plugins/Mu-scorpio/dsh-mineru。
核心功能¶
左側面板與任務管理¶
安裝並刷新 Harness 後，左側主導航會出現 MinerU 解析 入口，在獨立頁面完成上傳、選項配置與任務進度查看，而不是依賴零散彈窗。任務狀態由 Host 管理，切換頁面或刷新後仍可延續；出錯時提供錯誤碼與「一鍵重試」。
解析能力¶
- 基於 MinerU v4 API，支持數學公式識別（行內與獨立公式轉爲 LaTeX）、複雜與跨頁表格結構化、圖表多模態抽取。
- 可對掃描件或圖片型 PDF 開啓 OCR。
- 可選附加導出 docx、html 或 latex（界面中「附加導出」）。
超長 PDF 智能分片¶
官方 API 存在頁數限制。插件會感知 PDF 總頁數；超過 分片頁數 閾值（默認 200 頁）時自動分批請求，解析完成後在本地合併 Markdown 與圖片資源，並維護圖片引用路徑。
目錄與憑據¶
選中 PDF 後，保存目錄可預填爲該文件所在目錄，也可用系統目錄選擇器指定路徑。API Token 僅寫入 Harness 本地憑據庫 ~/.dsh/.credentials.yaml，界面輸入脫敏，不按 README 說明隨會話上傳。
Agent 工具¶
除面板外，插件註冊 mineru_parse 工具，對話中可由智能助手調用以解析指定 PDF 並讀取結果。
安裝與啓用¶
資料給出三種方式；社區插件市場屬於 DSH 生態的獨立目錄站點，與 DeepSeek / 幻方無官方從屬關係，僅在 Harness 內按下面步驟操作即可。
方式一：插件市場（推薦）¶
在 DeepSeek Harness 打開 設置 → 插件市場 (Plugin Market)，搜索 dsh-mineru，點擊 安裝。
方式二：DSH CLI¶
# 從 GitHub 倉庫直接添加
dsh plugin add github:Mu-scorpio/dsh-mineru
# 或從 Release 預打包文件免編譯極速安裝
dsh plugin add https://github.com/Mu-scorpio/dsh-mineru/releases/download/v1.0.0/dsh-mineru-1.0.0.tgz
啓用界面¶
安裝完成後刷新應用（Cmd + R / Ctrl + R），左側應出現 MinerU 解析 圖標。
方式三在 README 中面向本地開發（clone 與符號鏈接調試），一般使用者可跳過。
典型用法¶
下面步驟來自倉庫 README，可按順序復現。
- 在 MinerU 官方開放平臺 註冊並複製 API Token。
- 點擊左側 MinerU 解析，在「API 密鑰」欄粘貼 Token 並 保存（右上角應顯示綠色的「已配置」）。
- 拖拽或選擇單個/多個 PDF，確認解析選項後點擊 開始解析。
- 完成後結果歸檔到指定保存目錄，通常包含
full.md、圖片目錄，以及可選的 docx/html 等。
解析選項（節選，默認值以 README 表爲準）：
| 參數項 | 說明 | 推薦/默認值 |
|---|---|---|
| 模型版本 | vlm（多模態高精度）或 pipeline |
vlm |
| 文檔語言 | 如 ch（中/英混合）、en |
ch |
| 頁碼範圍 | 如 1-10,15；留空爲全文 |
留空 |
| 分片頁數 | 超過該頁數觸發切片與本地聚合 | 200 |
| 公式識別 | 轉爲 LaTeX | 開啓 |
| 表格識別 | 轉爲 Markdown 表格 | 開啓 |
| 啓用 OCR | 掃描件/圖片 PDF | 視文件類型 |
| 附加導出 | docx、html、latex | 可選 |
在對話中需要由助手代勞解析時，前提是插件已加載且 Token 已配置，再讓助手通過已註冊的 mineru_parse 處理指定 PDF。
適用場景與注意¶
適合誰：需要把含公式、複雜表格或掃描頁的 PDF 轉成可編輯 Markdown、並希望在 DSH 內完成上傳—進度—落盤一條鏈路的開發者與使用者；長文檔依賴內置分片，無需手動按頁切開再合併。
運行與信任邊界：插件以當前 DSH 進程權限運行，會訪問你選擇的 PDF 路徑、寫入保存目錄，並向 MinerU 雲端發起解析請求。安裝前建議閱讀 GitHub 源碼 與 MIT 許可證，自行評估是否將 Token 存入本地憑據庫。
依賴與網絡：解析質量與時效取決於 MinerU v4 服務與網絡；README 提到對解析結果 Zip 採用直連與流式解壓，以減輕部分網絡環境下的 TLS 重置與超時問題。
結尾¶
dsh-mineru 把 MinerU 的 PDF 結構化能力嵌進 Harness：面板負責日常批處理與選項調優，mineru_parse 負責對話內自動化。查閱安裝包信息與社區條目可訪問目錄頁 https://www.skillhub.cn/plugins/Mu-scorpio/dsh-mineru ，源碼與 Release 見 https://github.com/Mu-scorpio/dsh-mineru 。
