开源的 PDF 高精度解析工具,常用于中文文档入库——这是 MinerU 最主要的用途,也是本文讨论的前提。

下面按「现象 → 可能原因 → 处理办法」整理常见问题。

排查表

现象处理办法
答案引用了错误段落调整切分大小、加入重排序,并检查文档解析是否丢失标题。
表格内容检索不到换用能保留表格结构的解析工具,或单独把表格转成文本描述。
搜索结果过时限定时间范围,或在提问中注明需要最新信息并核对发布日期。
中文检索效果差选择对中文支持好的嵌入模型,并为专有名词建立同义词。
回答过于笼统要求逐条引用原文,并限定只回答文档中有依据的内容。

通用排查顺序

  1. 确认账号、额度和网络状态正常。
  2. 用一份简单材料复现问题,排除材料本身的干扰。
  3. 检查设置是否被改动(模型、语言、格式等)
  4. 查看官方状态页或更新日志。
  5. 仍无法解决时整理复现步骤联系官方支持。

用标准任务做对照测试

内部文档入库

适用情况:手头有一批 PDF、Word 和网页时。

把这些文档解析为干净的文本:保留标题层级和表格,去掉页眉页脚,按章节切分,每段附上原文件名和页码。

交付前确认:切分后的段落能回溯到页码。

更多可以试的用法

构建问答测试集

准备材料:一份产品手册。

根据手册编写 20 个用户可能问的问题及标准答案,标注答案所在章节,用来评估知识库检索效果。

验收标准:每个答案都能在手册中找到。

网页内容抓取

输入:一组需要定期关注的网页。

把这些网页转成 Markdown,去掉导航和广告,只保留正文、发布日期和作者;发布日期缺失时标注「未知」。

检查点:没有臆造发布日期。

带来源的快速调研

适用情况:手头有一个需要事实支撑的问题时。

请回答【问题】,每个关键结论后标注来源链接;如果不同来源说法不一,请分别列出;最后给出你认为最可靠的来源及原因。

验收标准:关键结论都有可点击来源。

常见问题:回答过于笼统

要求逐条引用原文,并限定只回答文档中有依据的内容。

常见问题:答案引用了错误段落

调整切分大小、加入重排序,并检查文档解析是否丢失标题。

常见问题:表格内容检索不到

换用能保留表格结构的解析工具,或单独把表格转成文本描述。

概念补充:嵌入(Embedding)

把文本转成向量,用于语义相似度检索。

概念补充:重排序(Rerank)

对初步检索结果再次打分排序,提升相关性。

适合人群:法务与律师助理

法务与律师助理可以用 MinerU 处理合同初审、法规检索等工作。需要注意:AI 输出不构成法律意见,条款和法规必须由执业人员核实。

适合人群:软件工程师

软件工程师可以用 MinerU 处理代码阅读与重构、测试与排错等工作。需要注意:不要把密钥和未开源代码上传到未授权工具,合并前审阅每处改动。

使用提醒

所有示例输出均为示意,不代表真实统计或效果承诺;请以自己的测试结果为准。

本文基于 MinerU 公开的定位与通用用法编写,具体功能、套餐与可用地区以官方页面为准,产品更新后界面和名称可能变化。

延伸阅读