精选的想法、故事和创意,全部汇集于此!

文章背景图

给 DeepSeek 接上眼睛(一):用 MinerU 读 PDF 和文档

2026-08-12
95
- 字
- 分钟

DeepSeek 原生接口读不了 PDF、图表和 Word。遇到这类文件,可以先用开源的 MinerU 把它们转成 Markdown,AI 就能正常读了。

1. 要准备的环境

工具 干嘛用的 备注
Python 3.10+ MinerU 跑起来的基础环境 建议用 Anaconda 单独建个环境,省得包冲突
Node.js & npm 用来装 MinerU 命令行工具 可以直接 conda install nodejs
MinerU CLI 转换文档的工具 npm install -g mineru-open-api
MinerU Token 解锁大文件和多页限制 去 mineru.net 免费注册,每天给 5000 次额度

2. 先在命令行跑通 MinerU

后面虽然是让 AI 自动调,但得先自己在终端装好确认能跑。

全局安装:

npm install -g mineru-open-api

跑一下版本号看看装上没有:

mineru-open-api --version

它有两种用法:

一种是不绑 Token 的快速模式,直接跑:

mineru-open-api flash extract 你的文件.pdf

默认直接把文字打在终端里,想存文件夹就加个 -O ./output_folder。不过这模式限制挺死,超过 10MB 或者超过 20 页的 PDF 就罢工了。

所以我建议直接用绑免费 Token 的高精度模式。去 mineru.net 微信扫码登录,在「API Manage Token」里建个 Token,回终端绑一下(只要绑一次):

mineru-open-api auth
# 按提示把 Token 粘进去就行

绑好之后就能转大文件了,比如把 PDF 转成 Markdown 存进 out 目录:

mineru-open-api extract 减少steam内存占据.pdf -O ./out -F markdown

绑了免费 Token 之后,单文件上限放宽到 200MB、600 页以内,每天有 1000 页额度,还能导出 markdown、html、latex、docx。平时看论文或者带表格公式的扫描件,基本都得靠这个模式。

3. 包成 Cloud Code 的 Skill

命令行跑通之后,没必要每次手动敲命令,直接让 AI 把它包成一个 Skill。

先给 Cloud Code 发这段话,让它找现成的 Skill:

请帮我查找适用于 Claude Code 的 MinerU 的 skill 技能,先不要直接进行配置,先告诉我有哪些 skill 可选。先前我已经通过以下命令进行了配置:npm install -g mineru-open-api

等它列出来,再让它装好:

请帮我安装配置适用于现在的 Claude Code 的 MinerU 的使用技能(skill),并告诉我下载来源、使用方法。

装完之后技能列表里会多出个 PDF Converter - MinerU。以后要读什么文档,直接在对话框里跟它说人话就行:

把当前目录下的这篇 PDF 论文转成 Markdown。
读取这个 Word 文档,总结核心内容。
分析这张图片里的表格数据,导出为 HTML。
将这个 Excel 文件转换为 Markdown 表格。

它会自己在后台调 MinerU 转成 Markdown 或 HTML,再读里面的内容回答你。


参考文献: - https://www.bilibili.com/video/BV1MSGr6PES5/ - https://github.com/opendatalab/MinerU - https://mineru.net

原创

给 DeepSeek 接上眼睛(一):用 MinerU 读 PDF 和文档

本文链接: 给 DeepSeek 接上眼睛(一):用 MinerU 读 PDF 和文档

本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。

评论交流
1 条