用 Codex、Zotero 和 Obsidian 打造论文精读与科研知识库：从文献管理到 AI 辅助写作的完整工作流
📌
在科研写作中，最耗时间的往往不是“写”本身，而是文献的收集、阅读、标注、整理、复盘和调用。我们经常会遇到这样的情况：Zotero 里存了几百篇论文，PDF 里画了很多高亮；Obsidian 里写了不少笔记，但真正写论文时却找不到合适的内容；AI 工具可以帮忙总结和改写，却又容易出现引用不准确、内容脱离原文的问题。
因此，一个理想的科研工作流应该同时满足三个要求：
文献来源要可靠；
阅读笔记要可沉淀；
AI 辅助写作要建立在自己的知识库之上，而不是让 AI 凭空生成内容。
基于这个思路，我们可以把 Zotero、Obsidian 和 Codex 联动起来，构建一个适合论文精读、文献综述、论文写作和长期科研积累的知识库系统。
这里的 Codex 指 OpenAI 的 Codex 编程助手，尤其是可以在本地终端运行的 Codex CLI。OpenAI 官方说明中提到，Codex CLI 可以在用户选定的本地目录中读取、修改并运行代码，这使它非常适合处理 Obsidian 这类基于本地 Markdown 文件的知识库。
一、为什么要把 Zotero、Obsidian 和 Codex 联动起来？
科研工作中，单独使用一个工具往往很难覆盖完整流程。
Zotero 擅长文献管理。它可以帮助我们收集、组织、标注、引用和共享研究文献，是非常成熟的文献管理工具。但是，Zotero 更适合管理“文献对象”，并不适合长期构建概念网络、研究框架和个人知识体系。
Obsidian 擅长知识管理。它适合用来做个人笔记、知识库和项目管理，并且支持在笔记之间建立链接，从而形成类似“个人维基”的知识网络。但是，Obsidian 本身并不是专业的文献管理器，如果完全依靠手动维护引用，很容易出现文献信息混乱、citekey 不一致等问题。
Codex 擅长自动化整理和批量处理。它可以读取 Obsidian Vault 中的 Markdown 文件，帮助我们批量整理文献笔记、生成综述草稿、检查引用键、提取研究问题、构建对比表，甚至编写脚本完成重复性任务。Codex 还可以通过 AGENTS.md 读取项目级说明，从而遵守我们给知识库设定的写作和整理规则。
所以，三者的关系可以这样理解：
🔗
Zotero：负责“文献来源”
Obsidian：负责“知识沉淀”
Codex：负责“智能整理与辅助写作”
最重要的是：不要让 AI 直接替代文献管理工具，而是让 AI 在你已经整理好的文献知识库之上工作。
近年来，关于 AI 生成引用错误的问题已有研究关注。例如，有研究指出，即使带有搜索能力的前沿模型在生成 BibTeX 条目时仍可能出现字段错误，尤其是在较新或低引用文献中更容易出错。这也提醒我们，在科研写作中，Zotero 应该作为参考文献的“事实来源”，而 Codex 更适合做整理、归纳和写作辅助。
二、三者联动的基本架构
一个稳定的联动系统可以设计为：
代码块
PowerShell
Zotero
├─ 收集论文
├─ 管理 PDF
├─ 阅读、标注、高亮
└─ 生成稳定的 citekey
↓
Obsidian
├─ 一篇文献 = 一篇 Markdown 笔记
├─ 一个概念 = 一张知识卡片
├─ 一个研究方向 = 一个项目文件夹
└─ 所有内容沉淀为本地知识库
↓
Codex
├─ 读取 Obsidian Vault
├─ 批量整理文献笔记
├─ 生成研究现状和综述草稿
这套系统的核心不是“工具越多越好”，而是让每个工具只做自己最擅长的事情。
Zotero 保存文献元数据和 PDF；Obsidian 保存可长期积累的阅读笔记、概念卡片和研究框架；Codex 则在这些结构化材料之上进行批量分析和写作辅助。
三、第一步：用 Zotero 管理文献和 PDF 标注
Zotero 是整个系统的文献源头。建议将所有论文、书籍、报告、网页资料都先进入 Zotero，而不是直接散落在电脑文件夹里。
在 Zotero 中，可以按照研究方向建立不同的 Collection，例如：
代码块
PowerShell
Zotero Library
├─ Oil Monitoring
├─ Deep Learning
├─ ...
阅读论文时，建议在 Zotero PDF 阅读器中完成三类标注：
•
黄色高亮：重要结论
•
蓝色高亮：方法与实验
•
红色高亮：问题、局限与争议
•
文字批注：自己的理解和可用于论文的位置
这样做的好处是，文献的原始信息、PDF 文件、高亮和批注都集中在 Zotero 中。后续导入 Obsidian 时，这些内容可以成为文献笔记的基础材料。
四、第二步：用 Better BibTeX 生成稳定引用键
如果你希望 Zotero、Obsidian、LaTeX、Markdown 和论文写作系统之间保持统一引用，那么 Better BibTeX 几乎是必备插件。
Better BibTeX 是 Zotero 的扩展，主要面向使用 LaTeX、Markdown 等文本化写作工具的用户，能够更方便地管理书目信息。它还支持将文献库或文献集合自动导出，并保持更新。
推荐设置一个稳定的 citekey 格式，例如：
代码块
PowerShell
auth.lower + year + shorttitle
生成效果类似：
代码块
PowerShell
smith2023wear
liu2024ferrography
zhang2025microscopy
在科研写作中，citekey 非常重要，它相当于每篇文献的“身份证”。后续在 Obsidian、LaTeX 或 Markdown 论文中都可以这样引用：
已有研究表明，深度学习方法能够提升磨粒图像识别的准确率 [@citekey]。
同时，可以将 Zotero 中的文献自动导出为一个 BibTeX 文件，放入 Obsidian Vault：
代码块
PowerShell
ResearchVault/
└─ references/
└─ library.bib
这样，Obsidian 和 Codex 都可以读取同一个参考文献数据库。Better BibTeX 的自动导出功能支持“Keep updated”模式，设置后可以在 Zotero 文献库变化时持续更新导出的 .bib 文件。
五、第三步：用 Obsidian 建立科研知识库
Obsidian 的优势在于，它不是一个封闭数据库，而是一个本地 Markdown 知识库。也就是说，你的每一篇笔记本质上都是一个 .md 文件，可以长期保存、迁移、版本管理，也可以被 Codex 读取和处理。
建议建立如下目录结构：
代码块
PowerShell
ResearchVault/
每个文件夹的作用如下：
•
00_Inbox：临时想法、未整理笔记
•
01_LiteratureNotes：文献精读笔记
•
02_Concepts：概念卡片，例如“微流铁谱”“注意力机制”“超分辨率”
•
03_Projects：具体论文或课题章节
•
04_Manuscripts：论文草稿、综述草稿、投稿材料
•
05_Templates：文献笔记模板、概念模板、项目模板
•
references：BibTeX 参考文献数据库
•
AGENTS.md：给 Codex 的知识库规则说明
这套结构的核心思想是：
🧠
文献笔记负责“读过什么”
概念卡片负责“理解了什么”
项目文件夹负责“正在写什么”
论文草稿负责“最终输出什么”
六、第四步：用 Zotero Integration 将文献导入 Obsidian
Obsidian 与 Zotero 的联动通常依靠社区插件 Zotero Integration。该插件可以从 Zotero 向 Obsidian 插入或导入引用、参考文献、笔记和 PDF 标注，并且要求配合 Better BibTeX 使用。
基本流程如下：
Zotero 安装 Better BibTeX
Obsidian 安装 Zotero Integration
在 Zotero 中阅读 PDF 并做标注
在 Obsidian 中调用 Zotero Integration
将文献元数据、摘要、标注和批注导入为 Markdown 笔记
推荐为 Zotero Integration 设置一个文献笔记模板。模板可以放在：
05_Templates/Literature Note Template.md
模板示例：
代码块
YAML
title: "{{title}}"
authors: "{{authors}}"
year: "{{date | format('YYYY')}}"
citekey: "{{citekey}}"
journal: "{{publicationTitle}}"
doi: "{{DOI}}"
tags:
literature
这样，每导入一篇新论文，就可以在 Obsidian 中生成一篇结构化文献笔记。
一篇文献不再只是 Zotero 里的一个条目，而是变成了可以被链接、检索、重组和写作调用的 知识单元。
七、第五步：用 Codex 读取和整理 Obsidian Vault
Codex 与 Obsidian 的联动不一定需要复杂插件。最简单、最稳妥的方式是：
把 Obsidian Vault 当成本地项目文件夹
让 Codex 在这个文件夹中工作
例如你的 Obsidian Vault 路径是：
代码块
PowerShell
E:\Obsidian\ResearchVault
可以在终端中进入该目录：
代码块
Bash
cd E:\Obsidian\ResearchVault
codex
然后你就可以让 Codex 读取整个知识库，例如：
代码块
Plain Text
请阅读 01_Literature 文件夹中与 wear particle classification 相关的文献笔记，
按照“传统图像处理方法、机器学习方法、深度学习方法、轻量化网络方法”
四个方面生成一份中文研究现状综述。
要求：
1. 不要虚构文献；
2. 所有引用必须使用已有 citekey；
3. 输出到 03_Projects/xx论文/研究现状.md。
因为 Obsidian 笔记是 Markdown 文件，Codex 可以直接读取、分析和修改。相比让 AI 随机回答，基于 Obsidian Vault 的方式更接近“在自己的科研资料库中进行检索和写作”。
八、给 Codex 准备 AGENTS.md
为了让 Codex 更理解你的知识库结构，建议在 Obsidian Vault 根目录新建一个 AGENTS.md 文件。
OpenAI 官方文档说明，Codex 会在开始工作前读取 AGENTS.md 文件，从而获得项目相关的指令和规范。对科研知识库来说，这个文件非常关键，因为它可以告诉 Codex：哪些文件可以修改，哪些文件不能修改，写作时如何引用，遇到信息不足时如何处理。
示例：
代码块
Markdown
# AGENTS.md
## 项目说明
这是我的 Obsidian 科研知识库，主要用于论文精读、文献综述、论文写作和科研项目管理。
## 文件夹说明
这个文件相当于给 Codex 的“科研助理工作手册”。
没有 AGENTS.md 时，Codex 只知道这是一个文件夹；有了 AGENTS.md 后，Codex 就知道这是一个学术知识库，并且会按照你设定的规则处理文件。
九、论文精读的推荐流程
真正高效的论文精读，不是读完一篇论文后随手写几句感想，而是把每篇论文转化为 可复用的知识模块。
推荐流程如下：
Zotero 收集论文
Zotero 阅读 PDF，完成高亮和批注
Zotero Integration 导入到 Obsidian
在 Obsidian 中补充结构化精读笔记
将重要概念拆成独立知识卡片
用双链连接文献、概念和项目
用 Codex 批量整理文献和生成综述
人工校对并回到原文核查
将成熟内容迁移到论文草稿
例如，读一篇关于磨粒图像分类的论文后，可以在 Obsidian 中形成三类笔记：
代码块
Plain Text
01_LiteratureNotes/liu2024-wear-particle-classification.md
02_Concepts/磨粒分类.md
03_Projects/xx论文/相关工作.md
三者之间可以互相链接：
代码块
Markdown
这篇论文主要讨论了 [[磨粒分类]] 中的深度学习方法，
这样，随着阅读量增加，你的知识库不再是一堆孤立笔记，而是逐渐形成一个围绕研究方向展开的 知识网络。
十、Codex 可以做什么？
1. 自动生成文献综述初稿
你可以让 Codex 读取某一主题下的文献笔记：
代码块
Plain Text
请读取 01_LiteratureNotes 中与 ferrography、wear debris、oil monitoring 相关的文献笔记，
生成一段中文研究现状，要求适合博士论文“研究背景与意义”部分。
Codex 的输出不应该直接作为最终论文，而应该作为 “可编辑初稿”。你需要检查逻辑、补充原文细节，并核对引用。
2. 生成文献对比表
代码块
Plain Text
请根据 01_LiteratureNotes 中关于 wear particle classification 的文献笔记，
生成一个 Markdown 表格，字段包括：
年份、作者、研究对象、方法、数据集、优点、局限性、citekey。
这种表格非常适合写综述、开题报告和论文 Introduction。
3. 检查引用是否存在
代码块
Plain Text
请检查 04_Manuscripts/introduction.md 中所有 [@xxx] 引用，
确认它们是否都存在于 references/library.bib。
如果不存在，请列出缺失 citekey，不要自动替换。
这一步可以减少论文写作后期常见的引用错误。
4. 把零散笔记改写为论文语言
代码块
Plain Text
请根据 03_Projects/xx论文/notes.md 中的要点，
改写为博士论文风格的“国内外研究现状”段落，
要求逻辑严谨、语言自然，并保留已有 citekey。
5. 批量整理新导入的文献笔记
代码块
Plain Text
请整理 01_LiteratureNotes 中最近导入但 status 为 unread 的文献笔记，
按照“研究问题、方法、实验、结论、局限性、可用于我论文的位置”重新归类。
这类任务特别适合 Codex，因为它可以批量处理多个 Markdown 文件，减少重复劳动。
十一、一个完整的科研写作案例
假设你正在写一篇关于“基于深度学习的磨粒图像识别”的论文，可以这样使用三者联动。
第一步，在 Zotero 中建立一个文献集合：
代码块
Plain Text
Wear Particle Classification
然后，将相关论文全部加入该集合，并在 Zotero 中完成 PDF 阅读和高亮。
第二步，通过 Zotero Integration 将这些论文导入 Obsidian：
代码块
Plain Text
01_LiteratureNotes/
├─ liu2022-wear-debris-classification.md
├─ zhang2023-ferrography-image-analysis.md
├─ wang2024-lightweight-cnn.md
└─ chen2025-attention-mechanism.md
第三步，在 Obsidian 中建立项目文件夹：
代码块
Plain Text
03_Projects/xx论文/
├─ 研究背景.md
├─ 国内外研究现状.md
├─ 方法对比.md
├─ 实验设计.md
└─ 投稿修改意见.md
第四步，让 Codex 辅助生成综述框架：
代码块
Plain Text
请基于 01_LiteratureNotes 中与 wear particle classification 相关的文献笔记，
为 03_Projects/xx论文/国内外研究现状.md 生成一个综述框架。
要求按照以下逻辑组织：
1. 油液监测与磨粒分析的研究意义；
2. 传统图像处理和机器学习方法；
3. 深度学习在磨粒识别中的应用；
💡
这个过程的价值在于：Codex 并不是从零开始“编”综述，而是在你的文献笔记和 Zotero 引用体系之上进行整理。这也是 AI 参与科研写作时最安全、最高效的方式。
十二、使用这套工作流时需要注意什么？
1. Zotero 是文献事实来源
不要让 Codex 随便生成参考文献。所有正式引用都应该来自 Zotero 和 library.bib。
2. Obsidian 是知识库，不是垃圾箱
不要把所有 PDF 标注不加整理地导入 Obsidian。导入只是第一步，真正有价值的是后续的重组、概括和链接。
3. Codex 是助理，不是作者
Codex 可以帮你整理、归纳、改写和检查，但最终判断仍然要由研究者完成。尤其是论文中的关键结论、数据、实验结果和引用，必须回到原文核查。
4. 文献笔记模板要统一
如果每篇文献笔记结构不同，Codex 后续处理就会变得困难。统一模板是后续自动化的基础。
5. citekey 要保持稳定
不要频繁修改 citekey。否则 Obsidian 笔记、LaTeX 文档和 BibTeX 文件之间可能出现引用断裂。
十三、推荐的最小可行配置
如果你刚开始搭建，不必一步到位。建议先完成以下五件事：
Zotero 安装 Better BibTeX
Obsidian 安装 Zotero Integration
Zotero 自动导出 library.bib 到 Obsidian 的 references 文件夹
Obsidian 建立 01_LiteratureNotes、02_Concepts、03_Projects 三个核心文件夹
在 Vault 根目录建立 AGENTS.md
✅
完成这五步后，你就已经拥有了一个基本可用的科研知识库系统。
十四、总结：让 AI 站在你的知识库之上
Codex、Zotero 和 Obsidian 的联动，本质上不是简单地把几个工具装在一起，而是 重新设计科研知识的流动方式。
过去的文献阅读流程往往是：
下载论文 → 阅读 PDF → 做一些高亮 → 过几天忘记 → 写论文时重新找
而新的流程应该是：
🚀
收集文献 → 精读标注 → 结构化笔记 → 概念链接 → 项目沉淀 → AI 辅助整理 → 人工校对写作
这套系统真正解决的问题，不只是“如何管理文献”，而是“如何让读过的论文持续为未来的研究服务”。
Zotero 负责保证文献可靠，Obsidian 负责沉淀知识结构，Codex 负责提升整理和写作效率。三者结合之后，科研知识不再散落在 PDF、文件夹和临时笔记中，而是逐渐变成一个可以检索、复用、扩展和写作调用的个人科研知识库。