dsh-mineru v0.1.9
基于 MinerU 的 DeepSeek Harness（dsh）多模态文档解析插件：PDF、Word、PPT、Excel、HTML、图片 → 结构化 Markdown。配置 MinerU Token 走 🎯 精准解析 API；不配 Token 也能用 ⚡ Agent 轻量解析 API（免登录，IP 限频）。
这是 dsh-mineru 的第一个 GitHub Release，汇总 0.1.2 → 0.1.9 的全部能力与变更。
✨ 核心特性
- 双 API 模式自动选择 — 有 Token 走精准解析 API（≤200 MB / ≤200 页，模型
pipeline/vlm/MinerU-HTML，Zip 输出full.md+ JSON + 可选 docx/html/latex）；无 Token 走 Agent 轻量解析 API（≤10 MB / ≤20 页，仅 Markdown，免登录）； - 四个工具、渐进式曝光 —
mineru_parse（单文档）、mineru_batch_parse（批量，自动分批）、mineru_task（超时续收），外加mineru-tools技能；平时只暴露极小的mineru_activate引导工具，激活后挂载完整工具集，省上下文； - 拖拽上传，纯文本模型也能用 — 把 PDF/Office/图片拖进聊天窗口，文件落到会话工作区、路径填入输入框草稿（不自动发送），完全绕开纯文本模型会拒绝的原生图片附件通道；
- 限流感知 — 内置令牌桶（提交 40 次/分钟、查询 900 次/分钟）、每日 5000 提交限额、HTTP 429 按
Retry-After退避重试、错误码全部映射为可操作提示； - Artifact 与 Web 界面 — 结果解包到
<workspace>/.dsh-mineru/artifacts/，附带 HMAC 签名预览链接；Web 设置卡片（Token 只写、高级设置折叠）+ 专属工具结果卡片。
🛠 工具
| 工具 | 说明 |
|---|---|
mineru_activate |
引导工具：一次调用解锁其余工具，之后对本会话隐藏 |
mineru_parse |
解析单个文档：工作区文件路径或 http(s) URL |
mineru_batch_parse |
精准解析批量解析：本地路径与 URL 混合列表，自动分批（每批 ≤50 文件 / ≤200 URL，单次 ≤1000） |
mineru_task |
查询/收集已提交任务（taskId + api）——超时后恢复收集，无需重复提交 |
🚀 安装
dsh plugin --profile web add dsh-mineru # Web 界面
dsh plugin --profile headless add dsh-mineru # 无头模式详细安装、配置与使用见 README.md。
📦 版本历史
0.1.9 — Docs
- 快速开始章节按官方插件 README 规范重构：安装拆分为「从 npm 安装（推荐）」与「从源码构建」双通道；新增
dsh --profile web --dump-config验证安装步骤；新增 headless 冒烟测试示例（中英两版同步）。
0.1.8 — Docs
- 重写双语 README 为详细版：三步快速开始、工具完整参数表、22 项配置参考、错误码速查与 FAQ；
- 新增
CHANGELOG.md（Keep a Changelog）与RELEASE.md（发布 SOP 清单）。
0.1.7 — Fixed
- 拖拽上传改为填入输入框草稿（不自动发送），由用户补充需求后自行发送；
- 清除拖拽残留的全屏遮罩。
0.1.6 — Docs
- 双语 README（
README.md英文 +README.zh.md简体中文），统一仓库 / npm / MinerU 链接。
0.1.5 — Fixed
- P3–P8 自检问题批量修复：
presentCall未定义崩溃、批量自动分批（≤50 文件 / ≤200 URL / 单次 ≤1000）、错误码映射补齐、ZIP 解包 CRC 校验与截断防护、上传同名冲突、版本号单一来源（package.json）。
0.1.4 — Fixed
- 工具结果序列化失败（
value is not lossless JSON）； mineru-toolsskill 加载失败（source must be a string）。
0.1.2 — Added（首个可用版本）
- 双 API 模式：精准解析 API（需 Token）/ Agent 轻量解析 API（免 Token）；
- 四个工具（
mineru_parse/mineru_batch_parse/mineru_task/mineru_activate）与mineru-tools技能； - 限流感知（令牌桶 + 429 退避 + 每日限额）；
- Artifact 落地与 Web 界面（设置卡片、工具结果卡片、HMAC 签名预览）。