适配 MinerU 3.4.0 · 仅支持 PDF 与图片源文件

把 MinerU 的产物变成一个可溯源的文档查看器

MinerU Viewer 是组件化的前端查看器:Markdown 与 PDF / 图片源文件块级双向联动、业务高亮注入。Vue 3 与 React 双封装,npm 与免构建双形态。

$ npm i @mineru-viewer/vue
Vue 3
官方封装
React 18
官方封装
MIT
开源协议
3.4.0
适配 MinerU 版本

一个组件,解决文档溯源的全部痛点

从 MinerU 的 zip 产物到"可用"的查看器,原本要重复造的轮子,这里一次封装到位。

块级双向溯源

点击左栏 Markdown 块,右侧源块自动滚动居中;点击源块,左侧对应块高亮。一切由稳定的 blockId 驱动。

业务高亮注入

addHighlight / setHighlights / clearHighlights / focusBlock:在任意块叠加问答引用、审查命中、标注。

开箱即用的 PDF 外壳

翻页、连续 / 单页、缩放、缩略图钉住(pin)、QQ 式自动收纳——PDF.js 渲染与 worker 已内置。

双框架封装

同一份 ESM 源码,Vue 3 与 React 18 经 Vite lib 模式构建,逻辑零分叉,能力完全一致。

双发布形态

npm(ESM + UMD)与免构建 script 全局引入。无打包工具也能用,mount(el, props) 即用。

版本适配透明

内置 v340 适配器,getAdapter 自动探测。适配新版本只需注册新实现,下游零改动。

几行代码即可接入

命令式挂载,无需框架也能用;框架内则有完整的组件与类型提示。

适合谁的文档溯源场景

论文 / 报告阅读器

点击正文段落即可跳到原版 PDF 对应区域核对。

合同 / 文档审查

审查规则命中处直接高亮源块,附批注与引用。

RAG / 知识库前端

把检索命中片段回链到原文,给出可验证出处。

标注 / 质检工具

在块级粒度上做标注,结果可写回业务侧持久化。

当前仅支持 PDF 与图片两种源文件。 MinerU 在这两种模式下才会返回符合预期的结构与版面坐标(bbox);其他格式(如纯文本、Office)暂不保证 blockId 映射准确。本项目适配的 MinerU 版本为 3.4.0

把文档溯源,交给一个组件

阅读文档、查看在线示例,或在 GitHub 上 Star 支持我们。