前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在将特定能力封装为可插拔组件。在开发智能体或处理文档时，对 PDF 进行高精度解析是一个常见需求。传统的解析方式往往在版面分析、公式识别或长文档处理上存在精度不足或阻塞对话的问题。本插件引入 MinerU 引擎，为 DSH 提供了原生的高精度 PDF 读取能力。
这是什么¶
dsh-pdf-mineru 是由 Yurzi 开发的一个 DSH 插件。它作为一个 Provider-independent 的工具，利用 MinerU 引擎为 Agent 提供文档解析能力。该插件解决了 AI 在处理复杂 PDF（如学术论文、研报）时，难以准确提取结构化信息（如公式、表格、版面）的问题。
核心功能¶
插件具备以下核心能力：
- 双端支持：支持 MinerU 官方云（v4）与私有化自建服务（v2），数据可不出内网。
- 高精度解析：提供文档版面分析、公式与表格提取、图文解析。
- 异步与缓存：原生支持后台异步任务与智能缓存，支持同步返回或后台处理；基于文件指纹与配置自动去重。
- 内容支持：支持双栏正文、目录、LaTeX 公式、表格、参考文献与插图。
- 便捷工具：提供内置可视化设置面板。
安装与启用¶
在 DeepSeek Harness 环境中执行以下命令即可安装插件：
dsh plugin --profile web add dsh-pdf-mineru
典型用法¶
配置完成后，无需记忆复杂指令，直接在聊天框中用自然语言对 Agent 下达需求即可。插件提供了多种交互模式：
- 基础解析：直接让 Agent 读取文档并提取正文、数学公式和表格，整理成 Markdown 格式。
- 长文档后台处理：对于超长文档，使用
async_parse_pdf提交任务。Agent 会返回任务 ID，将文档全量解析到本地缓存，并在完成后返回文档结构化摘要（如页数、大纲、图表数），期间不阻塞对话。 - 精准切片：通过参数控制读取范围。例如传入
pages: "1-5"与focus: "table"，读取指定页码的表格；或传入focus: "toc"查看目录。 - 内容精读与检索：使用
query: "图 7"进行字面检索；使用返回的block_id精读完整块，或使用物理页码与focus选择内容；对关键公式或图表，使用view: "page"回看原页。
适用场景与注意¶
使用本插件前，请确认以下环境与配置要求：
- 环境要求：运行环境需满足 Node.js
^22.19.0 || >=24.0.0。 - DSH 版本：仅支持 DeepSeek Harness 的 RC（Release Candidate）版本及后续正式发布版本。
- 任务控制器：宿主必须为该会话装配任务控制器（如
tool-jobs），否则启动时会拒绝解析。 - 错误处理：损坏、加密、解析失败、页码越界等错误不会通过切换后端进行重试。
- Poppler 依赖：当两后端均不可用时，插件会提示安装 Poppler；原页模式优先使用 PATH 中的 Poppler，缺失或不可执行时会自动回退到 PDF.js + Node Canvas。
- 任务取消：
job_kill仅取消本次等待，不会中止其他调用共用的解析生产者。
总结¶
dsh-pdf-mineru 通过集成 MinerU 引擎，为 DeepSeek Harness 提供了从云端到本地的 PDF 解析解决方案。其异步任务处理、智能缓存以及高精度的公式/表格提取能力，能够显著提升 Agent 处理文档的效率与准确性。
