PDF with MinerU

调用本地 MinerU 把 PDF 转成 markdown，再读取 markdown 内容完成用户任务。

MinerU 仓库在 ~/codes/MinerU。具体可调参数和 demo 见 ~/codes/MinerU/demo/demo.py。

步骤

1. 调用 mineru 转 markdown

获取 PDF 的绝对路径（用户给相对路径或文件名，先 Path(...).expanduser().resolve() 扩展），并确认文件存在、后缀是 .pdf。确认 ~/codes/MinerU 目录存在。CLI 通过 uv run mineru 调用，不要直接用 which mineru——系统 PATH 里的 mineru 缺 venv 依赖会报错（见边界情况）。

必须在 ~/codes/MinerU 目录下用 uv run mineru，让 uv 自动激活 venv、把 ninja 等构建工具带进 PATH：

cd ~/codes/MinerU && uv run mineru -p <pdf 绝对路径> -o ./.mineru-out/<pdf-stem> -b hybrid-engine -m auto -l ch

要点：