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,叫 desktop,只认它自带的 dsh 命令——npm 装的 dsh 会直接拒掉这个 profile。先在应用菜单里点 Manage dsh Command… 装上这个命令,打开一次桌面版再彻底退出,跑下面这条,然后重新打开桌面版。
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们的实装是在 npm 版 dsh 的 web profile 里跑的,没在桌面版上跑过。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 今天,DeepSeek Harness 0.2.2-rc.5.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 dsh-plugin-mineru 之前,先看这几条
- 源码在这里: HuanLinOTO/dsh-plugin-mineru——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:NOASSERTION。
安全
装 dsh-plugin-mineru 会执行什么
- 构建脚本
我们这次实装里没有构建脚本被拦。
来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.5,今天。
- 安装钩子
package.json 里没有 preinstall / install / postinstall 脚本。
来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。
- README 里提到
既没提 shell 命令,也没提密钥。
来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。
这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 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 协作。
我们跑过,装得上
基于工作区资料的 Studio,复用 DSH 模型与共享成果服务,制作报告、演示文稿、表格、思维导图、测验、闪卡及音视频。Office 生成需 Python 3.12+ 及相关依赖,并配置 DSH_OFFICE_PYTHON;媒体渲染需 Chromium;本地语音转写另需 whisper.cpp 和模型。
没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。
dsh-industry-research
PerryLink
面向 DeepSeek Harness 的确定性行业研究报告:公司与行业研究流程基于分阶段证据产出结构化、可核验的报告。
我们跑过,装得上
dsh-marktext
Roland0511
基于 MarkText 内核 muya 的右侧栏所见即所得 Markdown 编辑器:打开 .md 按渲染结果编辑,保存走 ctx.fs 并带版本守卫。
我们跑过,装得上