dsh-plugin-mineru
HuanLinOTO/dsh-plugin-mineru
向模型暴露 MineRU 文档解析工具。
安装
把 dsh-plugin-mineru 装进 DeepSeek Harness
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 14 天前.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 dsh-plugin-mineru 之前,先看这几条
- 源码在这里: HuanLinOTO/dsh-plugin-mineru——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:NOASSERTION。
- 被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。
AI 锐评
是什么 — 为 DeepSeek Harness 模型集成 MinerU 文档解析工具。
谁该装 — 在使用 DeepSeek Harness 构建代理时,如果模型需要解析文档文件以生成结构化内容,可安装此插件。 如果项目不通过 DSH 工具系统调用 MinerU,则无需安装此插件。
注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。 需自行部署 MinerU 实例才能使用此插件。 未发现明显的坑。
锐评 — 只要能快速部署 MinerU 服务器,此插件值得安装,因为它直接向模型暴露了解析工具。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
dsh-plugin-mineru 是做什么的

dsh-plugin-mineru 是一个 DeepSeek Harness 插件,用于向 agent 提供 MineRU 文档解析工具。它把本地 PDF、图片、DOCX、PPTX、XLSX 等文件提交到配置好的 MineRU API 服务,再将解析得到的 Markdown 或结构化 JSON 返回给模型。核心工具 mineru_parse_document 会依次完成提交、轮询和结果获取;需要批量或并行处理时,也可以分别使用 mineru_submit_parse_job、mineru_get_parse_status 和 mineru_get_parse_result,另有 mineru_health 检查服务状态。
DeepSeek Harness 插件通过 HTTP 连接 MineRU,baseURL 是必填配置,鉴权则由 apiKeyEnv 指向环境变量或凭据引用。输出过大的 Markdown 不会全部内联返回,完整内容会写入临时文件,结构化结果可通过 raw_result_path 保存。这个插件适合已经部署 MineRU、需要让 agent 读取复杂文档内容的场景;如果没有可访问的 MineRU API 服务,就不适合安装,因为 README 没有说明它能脱离服务独立解析文件。
dsh-plugin-mineru 的文档
dsh-plugin-mineru 的配置
DeepSeek Harness 将 dsh-plugin-mineru 加载到 web profile。可在 DeepSeek Harness GUI 设置页或 cordis.patch.yml 中配置:
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
baseURL |
string |
必填 | MineRU API 地址 |
apiKeyEnv |
credential-ref |
MINERU_API_KEY |
API key 的环境变量名或凭据引用 |
defaultBackend |
enum |
pipeline |
pipeline、vlm-engine、hybrid-engine、vlm-http-client 或 hybrid-http-client |
defaultParseMethod |
enum |
auto |
auto、txt 或 ocr |
defaultLang |
string |
ch |
pipeline 后端的语言代码 |
pollIntervalMs |
number |
2000 |
异步状态轮询间隔 |
pollTimeoutMs |
number |
600000 |
mineru_parse_document 的最大轮询时间 |
requestTimeoutMs |
number |
60000 |
单次 HTTP 请求超时 |
maxMdOutputChars |
number |
200000 |
Markdown 内联返回上限,超出后写入临时文件 |
dsh-plugin-mineru 的命令
DeepSeek Harness 提供五个工具:mineru_parse_document 解析本地文档并自动等待 Markdown 结果;mineru_submit_parse_job 提交异步任务并返回 task_id;mineru_get_parse_status 返回 pending、processing、completed 或 failed;mineru_get_parse_result 获取已完成结果,完整结构化 JSON 保存到 raw_result_path;mineru_health 检查服务健康状态、版本、队列深度和并发容量。
dsh-plugin-mineru 的环境要求
需要自行部署 MineRU 实例,并让 baseURL 可以访问。测试实例可以不配置鉴权,否则由 apiKeyEnv 指定 API key 的环境变量名或凭据引用。
dsh-plugin-mineru 的行为说明
插件通过 HTTP 提交文件并轮询异步任务。README 未说明所需的 DeepSeek Harness 版本或固定平台要求。
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
dsh-plugin-mineru 的同类插件
dsh-univer-office
dream-num
为 DeepSeek Harness 打造一个真正的办公环境。Univer Office 插件将电子表格、文档、幻灯片、画布、多维表格等汇聚到同一个运行时——数据互联、修改经过校验、变更按版本管理,并以隔离工作树支持多 Agent 协作。
我们跑过,装得上
dsh-industry-research
PerryLink
面向 DeepSeek Harness 的确定性行业研究报告:公司与行业研究流程基于分阶段证据产出结构化、可核验的报告。
我们跑过,装得上
dsh-office-tools
kw78
面向 agent 的工作区安全 Office 工具集:创建/读取 Word、创建/读取/更新 Excel、创建/读取 PowerPoint,并支持 PNG/JPG/GIF 图片排版。
我们跑过,装得上