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