dsh-mineru

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

安装

# 从 git 安装（推荐）：
dsh plugin --profile 
 add github:huanlinoto/dsh-plugin-mineru

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

pnpm ≥10 从 git 安装时，需在 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。大多数解析任务用这个即可。