1. 为什么要把 Zotero 文献流接进 Cursor

如果你正在写论文、做算法复现，或者维护一个长期的知识库，大概率会遇到这样一个尴尬局面：Zotero 里躺着几百篇 PDF 和批注，Obsidian 里散落着读书笔记，而真正要写代码、写论文段落的时候，却只能靠脑子回忆“那篇讲 MARL 的论文里到底怎么定义 reward shaping 的”。文献管理和写作产出之间，缺了一条能自动流转的管道。

我试过最原始的做法：手动复制 Zotero 的引用，粘贴到 Cursor 的 Chat 里问问题。结果就是每次都要重新贴一遍，上下文一长就丢，而且 Cursor 根本不知道你整个文献库长什么样。后来才想明白，问题的核心不是“AI 能不能读文献”，而是“AI 能不能索引你整个文献库的上下文”。Zotero 本身是二进制数据库，Cursor 读不懂；Obsidian 是纯 Markdown，Cursor 能读；所以 Obsidian 天然就是那个中转层。

这套方案能做什么？简单说，就是让 Zotero 里的每一条文献、每一条批注，自动变成 Obsidian 库里的.md文件，再让 Cursor 对整个库建立索引。之后你在 Cursor 里写论文段落或者算法代码时，可以直接@某个笔记文件，或者让 Cursor 全库检索“所有提到 attention 机制的文献笔记”，它就能把 Zotero 里的原始文献和你的个人批注一起作为上下文来回答。适合谁？适合正在做文献综述的研究生、需要复现论文算法的工程师，以及任何想把“读过的文献”真正变成“可检索上下文”的人。

这里有个关键区分：Zotero 的 GPT 类插件通常只服务“输入”，也就是帮你读懂当前这篇 PDF；而把 Obsidian 笔记库接进 Cursor 服务的是“输出”，也就是用全库检索来写论文、写代码。两者不是替代关系，是上下游关系。而要让 Cursor 稳定调用模型，你需要一个统一的 API 入口，这就是 TaoToken 出场的地方——它把模型调用统一成一个 Key、一个 Base URL，省得你在 Cursor、Obsidian 插件、脚本之间来回切换配置。

2. TaoToken 前置：统一 Key 与 Base URL 的准备

在动手配置 Obsidian 和 Cursor 之前，先把模型调用的“总闸”装好。很多人卡在这一步不是因为难，而是因为 Cursor 默认走的是它自己的模型通道，你想换成自己的 Key 时，Base URL 和 Model ID 填错一个字符就报 401。TaoToken 的作用就是给你一个兼容 OpenAI 协议的统一入口，一个 Key 可以调多种模型，Cursor、Obsidian 插件、命令行脚本都能共用。

先拿到 Key。打开 TaoToken 的 API Keys 页面（https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite），登录后创建一个新的 Key，复制下来。这个 Key 就是你后面所有配置里要填的凭证，建议先存到密码管理器里，别直接写在笔记里。

然后是 Base URL。TaoToken 的 API 地址是https://taotoken.net/api，注意这里不加任何 UTM 参数，配置里就填这个。如果你用的是 OpenAI 兼容的客户端，通常还需要在末尾补/v1，也就是https://taotoken.net/api/v1，具体看客户端要求。Cursor 的配置里填的是不带/v1的 Base URL，它会自己拼接路径。

Model ID 这块，TaoToken 支持多种模型，你在模型对话页面（https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite）可以先试一下哪个模型适合你的文献问答场景。一般来说，长上下文模型更适合全库检索，因为要吞下大量笔记内容。选好之后把 Model ID 记下来，比如gpt-4o或者claude-3-5-sonnet这类，后面 Cursor 配置里要用。

如果你打算长期用 Cursor 做编码和 Agent 任务，可以看一下 Coding Plan（https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite），它针对编码场景做了额度优化，比按量计费更适合天天开着 Cursor 的人。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite，里面有各客户端的详细配置示例，遇到不确定的字段可以先翻一下。

这里要提醒一句：TaoToken 是合规的 API 聚合入口，不是那种来路不明的中转，你的 Key 和请求都是走正常接口。配置的时候只要保证 Base URL、Key、Model ID 三件套一致，基本不会出问题。下面进入具体配置。

3. 可复制配置：Obsidian 插件、Zotero 导出与 Cursor Base URL

这一节是整篇的核心，我会把三个环节的配置都写成可以直接复制粘贴的形式。你按顺序做，中间不要跳步，尤其是 Zotero 的导出模板和 Obsidian 的插件设置，字段填错会导致后面 Cursor 读不到笔记。

3.1 Zotero 端：Better BibTeX 导出 .bib 与自动更新

先装 Better BibTeX。打开 Zotero，工具 → 插件 → 齿轮图标 → Install Plugin From File，选择下载好的.xpi文件。装完后重启 Zotero。然后右键你要导出的分类，选择 Export Collection，格式选Better BibLaTeX，务必勾选“保持更新”（Keep updated），保存到你的 Obsidian 库目录下，比如~/Obsidian/MyVault/refs/library.bib。

这个.bib文件就是 Cursor 的“骨架”，里面是所有文献的元数据。勾选保持更新后，你在 Zotero 里新增条目，.bib会自动同步，Cursor 重新索引时就能看到新文献。

3.2 Obsidian 端：Zotero Integration 插件配置

在 Obsidian 里，设置 → 第三方插件 → 关闭安全模式 → 浏览 → 搜索 “Zotero Integration” 安装并启用。然后进入插件设置，按下面填：

General Settings 里，PDF Utility 点 Download，它会下载pdfannots2json工具；PDF Utility Path Override 点 “Download the executable here”，下载对应你系统的版本，解压后放到 Obsidian 库文件夹里。Database 保持 Zotero。Note Import Location 填一个子文件夹名，比如zotero-notes，插件会自动创建。Open the created or updated note(s) after import 建议开启，Which notes to open after import 选 First imported note。

Citation Formats 是防止 AI 幻觉的关键。点 Add Citation Format，Name 随便填比如APA，Output Format 保持 Formatted Citation，Citation Style 下拉搜索选American Psychological Association 7th edition。这样每篇笔记里会有[@wang2026Spatial]这样的唯一标识，Cursor 引用时能准确定位。

Import Formats 决定 Markdown 排版。点 Add Import Format，Name 自定义，Output Path 填zotero-notes/{{citekey}}.md，Image Output Path 保持{{citekey}}/，Image Base Name 保持image，Template File 需要你先在 Obsidian 的模板文件夹里建一个Zotero_Template.md，然后在下拉里选中它。Bibliography Style 同样选 APA 7th。

模板文件Zotero_Template.md的内容可以这样写，直接复制：

--- title: {{title}} authors: {{authors}} year: {{date | format("YYYY")}} citekey: {{citekey}} --- ## 摘要 {{abstractNote}} ## 我的批注 {{annotations}} ## 引用 {{bibliography}}

Import Image Settings 里 Image Format 和 Quality 保持默认，Image OCR 建议关闭，除非你大量处理扫描版 PDF。

3.3 Cursor 端：Base URL 与 Model ID 配置

打开 Cursor，进入 Settings → Models。在 OpenAI API Key 那一栏，填入你的 TaoToken Key。然后找到 “Override OpenAI Base URL” 或者类似的选项，填入https://taotoken.net/api。Model ID 填你在 TaoToken 模型对话页面选好的那个，比如gpt-4o。

如果你用的是 Cursor 的settings.json方式配置，可以在项目根目录的.cursor/settings.json里写：

{ "openai.apiKey": "你的TaoToken Key", "openai.baseUrl": "https://taotoken.net/api", "openai.model": "gpt-4o" }

注意 Base URL 不要加/v1，Cursor 会自己处理。Key 不要提交到 Git，建议用环境变量或者本地配置文件。

三件套对照表：

4. 验证请求：从 Zotero 新增条目到 Cursor 引用补全

配置写完不算完，得跑一次端到端验证，确认整条链路是通的。这一步我会从 Zotero 新增一条文献开始，一直走到 Cursor 里成功引用补全。

第一步，在 Zotero 里新增一条条目。随便找一篇你手头的论文，右键 → New Item → 填上标题、作者、年份。保存后，因为之前勾了“保持更新”，library.bib会自动更新。你可以打开.bib文件确认一下，应该能看到新条目的 citekey。

第二步，在 Obsidian 里按Ctrl + P打开命令面板，搜索 “Zotero Integration: 你的模板名”，选中后它会弹出 Zotero 的文献选择窗口。找到刚新增的那条，点右箭头导入。Obsidian 会在zotero-notes/下生成一个{{citekey}}.md文件，里面包含摘要、批注和 APA 引用。

第三步，回到 Cursor，打开你的项目文件夹（这个文件夹应该包含 Obsidian 库，或者至少包含zotero-notes和library.bib）。在 Cursor Chat 里输入@library.bib加上你的问题，比如 “这篇关于 reward shaping 的论文核心贡献是什么”。如果配置正确，Cursor 会读取.bib和对应的.md笔记，给出基于文献的回答。

第四步，验证引用补全。在 Cursor 里新建一个 Markdown 文件，输入[@，如果 Cursor 能弹出你 Obsidian 笔记里的 citekey 补全列表，说明索引已经生效。选中一个 citekey，它会自动补全成[@wang2026Spatial]这样的格式。

如果这一步成功了，整条链路就通了：Zotero 新增 →.bib自动更新 → Obsidian 生成笔记 → Cursor 索引并补全。你之后写论文时，直接在 Cursor 里@相关笔记，就能让模型基于你的全库文献来回答。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

配置过程中最容易撞上的几个报错，我按实际遇到的频率排一下，每个都给出对照的解决动作。

401 Unauthorized。这个基本是 Key 或 Base URL 填错。先检查 TaoToken 的 Key 有没有复制完整，前后有没有空格。然后确认 Base URL 是https://taotoken.net/api，不要多写/v1或者少写https。如果用的是 Cursor 的 settings.json，注意 JSON 格式不能有注释，逗号也不能多。改完重启 Cursor。

local proxy failed。这个报错通常出现在 Cursor 尝试走本地代理但代理没开或者端口不对。如果你没有用代理，去 Cursor 设置里把 Proxy 设为 None 或者直接留空。如果你在用系统代理，确认端口和 Cursor 里填的一致。这个错和 TaoToken 本身无关，是本地网络配置问题。

reading choices 相关报错。这个一般出现在模型返回格式不符合预期时，比如你选的 Model ID 不支持某些参数。去 TaoToken 模型对话页面确认这个模型是否支持 Cursor 需要的 function calling 或 streaming。如果不支持，换一个支持这些能力的模型 ID。

OAuth 相关报错。如果你在 Cursor 里登录的是官方账号，又同时填了自定义 Base URL，可能会冲突。解决方法是退出 Cursor 官方账号登录，只用 API Key 模式。或者在 Cursor 设置里明确选择 “Use custom API key” 而不是 OAuth 登录。

Zotero Integration 报 duplicates found。这个在 Obsidian 导入时出现，说明 Zotero 里有重复条目。去 Zotero 左侧面板找到“重复条目”，选中后点 merge，合并完再重新导入。

CSL style not found。这个报错说明 Citation Style 没选对。回到 Obsidian 插件设置的 Citation Formats，确认下拉里选的是 APA 7th，而不是手动输入的名称。改完先重启 Zotero，再重启 Obsidian，让样式库重新加载。

排查的时候记住一个原则：先确认 TaoToken 的 Key 和 Base URL 在模型对话页面能正常出结果，再去查 Cursor 和 Obsidian 的配置。这样能把问题范围缩小到具体环节。

6. 长期使用建议与 CTA

跑通之后，这套流程可以长期用。几个实用技巧：.bib文件建议放在 Obsidian 库根目录，Cursor 打开库文件夹时能直接索引；zotero-notes子文件夹不要手动改文件名，因为 citekey 是关联的；如果你文献量很大，Cursor 索引可能慢，可以在设置里排除一些不相关的文件夹。

如果你打算把 Cursor 作为日常编码和论文写作的主力，建议看一下 Coding Plan（https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite），额度更适合长期高频使用。接入过程中遇到配置问题，接入文档（https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite）里有各客户端的完整示例。想先试试模型效果，可以直接去模型对话页面（https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite）跑几个文献问答。Key 的管理在 API Keys 页面（https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite），建议定期轮换。

最后一步，打开你的 Cursor，在 Chat 里输入@library.bib加上一个你最近在读的论文关键词，看看它能不能准确引用到对应的 Obsidian 笔记。如果能，这套文献流就算真正跑起来了。