DeepSeek Harness Hub
← 返回列表

HuanLinOTO/dsh-plugin-mineru

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
⚠ 装前注意

DSH 插件:向模型暴露 MinerU 文档解析工具。MinerU 可将 PDF、图片、DOCX、PPTX、XLSX…

基本兼容但装前注意:未发布到 npm registry,仅可从源码安装 · 最近上游提交 2026/9/11 · 已提供中文文档

向模型暴露 MinerU 文档解析工具,将 PDF/图片/DOCX/PPTX/XLSX 转为结构化 Markdown/JSON | Exposes MinerU document-parsing tools to the model, converting PDF/images/DOCX/PPTX/XLSX into structured Markdown/JSON

综合分
49.7
GitHub 分
49.7
用户评分
★ Stars
48
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add HuanLinOTO/dsh-plugin-mineru
未发布到 npm registry,仅可从源码安装,改用 GitHub 源安装
🟢实装验证通过· 2026/9/19
由 dsh-plugin-verify(GitHub Actions)在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/17(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查⚠ 装前注意

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包@huanlin/dsh-plugin-mineru(未发布到 npm,仅可源码安装)
Node 引擎要求 >=18.0.0 · 基线 Node 22.19 满足
dsh CLI 依赖未声明 dsh 版本约束
入口文件main/exports/bin 已声明

未发布到 npm registry,仅可从源码安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/17 21:21:43

依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-client-connection@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-ui-renderer@deepseek-ai/dsh-client-ui-settings@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-llm@deepseek-ai/dsh-tools
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

dsh-mineru

npm version

DSH 插件:向模型暴露 MinerU 文档解析工具。MinerU 可将 PDF、图片、DOCX、PPTX、XLSX 等文件转换为结构化的 Markdown / JSON。

安装

从 npm 安装(推荐):
dsh plugin --profile web add @huanlin/dsh-plugin-mineru

从本地 checkout 开发安装:
dsh plugin --profile web add link:D:\Projects\deepseek-harness\dsh-mineru

若从 git 安装(pnpm ≥10),需在 profile 的 pnpm-workspace.yaml 中允许构建:

allowBuilds:
'@huanlin/dsh-plugin-mineru': true

配置

在 DSH GUI 设置页或 cordis.patch.yml 中配置:

| 字段 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| baseURL | string | (必填) | MinerU API 地址,如 http://your-mineru-host:18000 |
| 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 最大轮询时长(10 分钟) |
| requestTimeoutMs | number | 60000 | 单次 HTTP 请求超时 |
| maxMdOutputChars | number | 200000 | 内联返回给模型的 markdown 字符上限;超出时完整内容存到临时文件 |

工具

mineru_parse_document(推荐)

解析本地文档并返回提取出的 markdown。内部自动完成:提交文件 → 轮询至完成 → 返回 markdown。大多数解析任务用这个即可。

mineru_submit_parse_job

异步提交解析任务,立即返回 task_id。适合大文档或并行批量提交。

mineru_get_parse_status

轮询异步任务状态,返回 pending / processing / completed / failed。

mineru_get_parse_result

获取已完成任务的结果。内联返回 markdown(过大则截断),并将完整结构化 JSON 存到 raw_result_path。

mineru_health

检查服务器健康状态、版本、队列深度与并发容量。

开发

pnpm install          # 安装开发依赖(schemastery、typescript、vitest)
pnpm run typecheck    # tsc --noEmit 类型检查
pnpm test             # vitest run 单元测试
pnpm run build        # tsdown 构建 → lib/

目录结构

dsh-mineru/
├── src/
│   ├── index.ts        # 入口:name、inject、Config(Schemastery)、apply
│   ├── client.ts       # MinerUClient(基于 fetch 的 HTTP 客户端 + 类型)
│   ├── tools.ts        # 5 个 defineTool 定义 + 辅助函数 + registerTools
│   └── types.d.ts      # @deepseek-ai/dsh-tools + cordis 的环境类型声明
├── tests/
│   └── tools.spec.ts   # 单元测试(mock fetch,无需真实服务器)
├── cordis.patch.yml    # bundle 层:插入 dsh-mineru 插件行
├── package.json        # dsh.bundle.patch 声明 + peerDeps
└── tsconfig.json       # NodeNext、ES2022、strict

测试 API

请自己部署 MinerU 实例。cordis.patch.yml 默认指向 http://localhost:18000,请在 DSH GUI 中覆盖 baseURL 改为你的 MinerU 服务器地址。

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群