Zotero + MinerU + Codex：一键把论文 PDF 变成快读、精读、写作级精读笔记

Zotero + MinerU + Codex：一键把论文 PDF 变成快读、精读、写作级精读笔记

如果你平时用 Zotero 管理论文，大概率遇到过这些问题：

• PDF 堆在 Zotero 里，真正读起来还是要自己一点点摘录。
• 图表、公式、技术路线很难快速整理成结构化笔记。
• 读完一篇论文后，摘要有了，但写综述、写 Introduction、复用表达时还是要重新翻。
• AI 可以帮忙读论文，但生成的笔记经常和 Zotero 文献库分离，后续不好追踪。

我最近做了一个 Codex skill：MinerU Zotero Reader。它的目标很直接：

在 Zotero 里右键 PDF，选择“快读 / 精读 / 写作级精读”，自动调用 MinerU 把 PDF 解析成 Markdown，再让 Codex 基于 Markdown 生成阅读笔记，并把笔记挂回 Zotero 原文献条目。

项目地址：

https://github.com/zxc-heu/mineru-zotero-reader

安装教程：

https://github.com/zxc-heu/mineru-zotero-reader/blob/master/docs/INSTALL.zh-CN.md

它解决的不是“摘要”问题，而是“读论文工作流”问题

普通 AI 读 PDF 通常卡在三个地方：

1. PDF 解析不稳定：双栏、公式、图表、参考文献容易混在一起。
2. 输出不落地：结果只停留在聊天窗口里，和 Zotero 文献库断开。
3. 阅读深度不可控：有时只是摘要，有时又太长，很难按场景切换。

这个 skill 的设计思路是把流程拆开：

• Zotero 继续负责管理文献和 PDF。
• MinerU 负责把 PDF 解析成更适合 AI 阅读的 Markdown。
• Codex 负责按预设的阅读模式生成笔记。
• Zotero 桥接插件负责把生成的 Markdown 笔记挂回原文献。

整体工作流如下：

在 Zotero 里一键启动

安装 Zotero 桥接插件后，在 Zotero 里右键文献或 PDF 附件，可以看到“一键阅读”菜单：

目前主要有三种模式：

• 快读：判断这篇论文值不值得继续读。
• 精读：把论文整理成结构化研究笔记。
• 写作级精读：拆解文章结构、证据组织和可复用写法。

生成完成后，Markdown 笔记会作为 linked attachment 挂回 Zotero 原条目，不会变成一个孤立文件：

三种阅读模式分别适合什么场景

1. 快读：先判断有没有必要继续读

快读适合在文献筛选阶段使用。它不会把论文拆得特别细，而是快速回答几个关键问题：

• 这篇论文的核心结论是什么？
• 和我的研究方向是否相关？
• 主要方法是什么？
• 是否值得继续精读？

示例效果：

我自己的使用习惯是：新导入 Zotero 的论文，先批量跑快读。看完快读结论后，再决定哪些论文值得进入精读。

2. 精读：把论文变成结构化研究笔记

精读适合真正要理解方法、结果和图表的论文。它会更关注：

• 一句话总结
• 研究背景与问题
• 核心研究目标
• 方法路线
• 关键图表解读
• 结果和局限

示例效果：

这类笔记适合后续做组会汇报、写 related work、整理方法对比表。它不是只给一个摘要，而是尽量把论文拆成“以后可以复用的研究材料”。

3. 写作级精读：为写论文和综述准备材料

写作级精读更偏向“学术写作训练”。它不仅关心论文讲了什么，还会分析：

• 文章结构怎么安排
• Introduction 如何提出问题
• 方法部分如何承接
• 结果如何解释
• 哪些表达方式可以模仿，但不能照抄

示例效果：

这个模式尤其适合以下两类场景：

• 写综述时，需要从大量论文中提炼问题提出方式和论证逻辑。
• 写自己的论文时，需要学习同领域论文如何组织 Introduction、Methods、Results 和 Discussion。

安装后实际怎么用

完整教程在这里：

https://github.com/zxc-heu/mineru-zotero-reader/blob/master/docs/INSTALL.zh-CN.md

简化流程如下。

第一步：安装 skill

推荐安装到默认 Codex skill 目录：

git clone https://github.com/zxc-heu/mineru-zotero-reader "$env:USERPROFILE\.codex\skills\mineru-zotero-reader"

目录里应该能看到：

SKILL.md
README.md
scripts\
references\
assets\
bridge-src\

第二步：安装 Zotero 桥接插件

在 skill 目录中找到：

assets/zotero-bridge/codexzoterobridge-installable@polygon.org.xpi

然后在 Zotero 中：

1. 打开 Tools / Add-ons。
2. 点击齿轮按钮。
3. 选择 Install Add-on From File...。
4. 选择上面的 .xpi 文件。
5. 重启 Zotero。

第三步：配置 MinerU API Token

项目使用 MinerU 的精准解析 API，需要配置环境变量：

[Environment]::SetEnvironmentVariable("MINERU_API_TOKEN", "你的 MinerU Token", "User")

配置后重启 Zotero。

第四步：确认 Codex CLI 与 uv 已可用

需要能运行：

codex --version
codex login status
uv --version

如果你是第一次装，建议直接按照安装教程一步步检查。

第五步：在 Zotero 中右键阅读

选中一条带 PDF 的文献，右键选择：

• 快读
• 精读
• 写作级精读

任务完成后，阅读笔记会出现在 Zotero 条目的附件列表里。

我觉得它最适合这些人

这个工具不是为了替代自己读论文，而是为了把重复劳动自动化。比较适合：

• 需要长期维护 Zotero 文献库的研究生。
• 经常做文献调研、综述、组会汇报的人。
• 读论文时希望保留结构化 Markdown 笔记的人。
• 想把论文阅读、Zotero 管理和 AI 笔记生成串起来的人。
• 需要从论文中学习写作结构和表达方式的人。

如果你只是偶尔问 AI 一篇论文讲了什么，普通聊天工具也够用。但如果你每天都在 Zotero 里管理 PDF，并且希望阅读笔记能归档到文献库中，这个 skill 会更顺手。

当前版本能力

当前公开版本为 v0.3.16，主要能力包括：

• Zotero 右键一键阅读。
• 快读、精读、写作级精读三种模式。
• 使用 MinerU 将 PDF 解析为 Markdown。
• 已有同名 Markdown 时优先复用，避免重复解析。
• 生成的阅读笔记自动挂回 Zotero 原条目。
• 支持自定义 skill 安装路径。

项目地址：

https://github.com/zxc-heu/mineru-zotero-reader

安装教程：

https://github.com/zxc-heu/mineru-zotero-reader/blob/master/docs/INSTALL.zh-CN.md

最后

我做这个 skill 的初衷很简单：论文阅读不应该停留在“我让 AI 总结了一下”，而应该变成一个可积累、可回看、可复用的工作流。

Zotero 管理文献，MinerU 解析 PDF，Codex 生成不同深度的阅读笔记，再挂回 Zotero。这样每篇论文读完后，不只是多了一段聊天记录，而是在文献库里多了一份可以继续使用的研究资产。

如果你也在用 Zotero 管理论文，可以试一下这个工作流。