晚上十一点我对着屏幕发了半小时呆。Zotero 里躺着四十几篇 PDF标题、摘要、关键结论分布在不同的标签页里我需要在下周交出一篇像样的文献综述。以前的做法是把每一篇文献的关键信息复制到 Word手动归好类再一段一段组织语言光是搭骨架就耗掉一整个晚上。那段时间我一直在想如果有一个工具能帮我把“整理文献信息”和“写综述初稿”这两段重复劳动真正接起来而不是只给我一个聊天框让我自己复制粘贴效率会完全不一样。后来我试着把 Zotero 和 Codex 放在同一条工作流里跑了几个来回发现这个组合真正值钱的不是“一句话生成一篇综述”这种夸张说法而是它把文献管理、内容生成、事实核对拆成了三件可控的事。一句话生成初稿只是其中最简单的部分真正麻烦的是怎么让 Codex 知道你到底有哪些文献、哪些观点来自哪一篇、以及哪些结论不能让它自由发挥。这篇文章不打算重复那些“效率提高十倍”的话我想把这条联动链路拆开讲清楚它到底解决什么问题、怎么跑通以及为什么它不适合所有人。1. 先搞清楚“联动”解决的是哪一类重复劳动先说一个容易误解的地方Codex 和 Zotero 并不是官方出品的“一键联动插件”。网上讨论的“联动”本质上是一条你自己的工作流Zotero 负责把文献管好Codex 负责通过脚本或终端读取文献信息、生成结构化内容。Zotero 是文献侧的资料库Codex 是生成侧的助手两者通过“中间数据”连接起来。1.1 写综述真正的耗时点不在“写”一篇文献综述写不出来往往不是因为找不到话说而是“信息太散”。你读完十篇论文知道它们都在讨论同一个问题但每篇的方法、样本、结论、亮点不在同一个地方。要组织成一段有逻辑的话你得先把这些信息从 PDF 里拽出来再手动对齐它们之间的异同。这个过程非常机械也非常容易出错。Zotero 的价值在于它把“文献管理”变成了一件可以快速检索和批量导出的事情。你可以给文献打标签、建分类、写笔记还可以一键导出 BibTeX 或者标准格式的引用信息。Codex 的价值在于它可以把一份结构清晰的文献清单转换成一段结构清晰的综述初稿并且按照指定的风格和顺序组织。两者拼在一起写综述的前半段——整理材料、确定结构、产出一版草稿——就被缩短到一个很小的范围里。这里需要说清楚Codex 不会替你做文献阅读也不会替你做判断。非常容易理解它的边界是如果 Zotero 里的条目本身信息不全或者你的笔记里没有提炼观点那 Codex 生成出来的综述就会非常空洞甚至会编造出一些看起来合理的引用。所以这条工作流的前置条件是你已经做完了基础的阅读和笔记整理Codex 做的是“把这些零散信息组织成文”的这一步而不是“代替你理解文献”的那一步。1.2 为什么这个流程会比纯聊天式写作更稳很多人用过 ChatGPT 或类似的 AI 工具写综述感受通常是第一版很流畅但引文经常对不上或者它会把几篇文献的观点写串。原因很简单——你在聊天框里给了它一句话它只能凭自己的知识去补全细节而它的“知识”里没有你本地那几十篇 PDF 的实际内容。Zotero 加 Codex 的联动思路是用文献库里的结构化数据约束生成过程。你在 Zotero 里把每篇文献的作者、年份、摘要、关键词、页码整理好然后把它导出成一个干净的文本再交给 Codex。这时候 Codex 是在你提供的真实文献信息上做重组而不是在它的训练记忆里猜。看起来只是多了一步“导出”但这一步决定了生成结果是否可信。所以“联动”的核心不是让 Codex 变得更能写而是让它从“凭印象写”变成“按材料写”。这是效率提升的真正来源也是这篇文章最重要的一个判断。2. 搭建最小环境Zotero 和 Codex 都要先能独立工作不要一上来就追求高级的自动化脚本。先让两个工具分别跑通自己的核心功能再谈联动。这个顺序能帮你省掉大量不必要的排查时间。2.1 Zotero 这边先把文献库变成结构化数据我建议你打开 Zotero先检查三件事条目信息是不是完整的。光有 PDF 文件不算完整作者、年份、期刊、摘要这些字段要能在右侧信息栏里看到。如果是从网页直接抓取的很容易出现只有标题和链接的情况这种条目导出后信息会很单薄。附件路径是不是稳定的。如果你把 PDF 放在 Zotero 的存储目录里换电脑或迁移库的时候要先确保目录没断。很多人用坚果云或 WebDAV 同步 Zotero这一步如果配置不对插件抓取或导出时就会报“找不到文件”这类错误。有没有已经写好的笔记。如果你是认真想用 AI 辅助写综述我建议每篇文献写 2 到 3 条笔记内容可以包括研究问题、核心方法、主要结论、与你当前综述主题的关系。不要写长只写要点。完成这三步之后你可以先在 Zotero 里做一次小范围导出测试。选中你将来要写进综述的十几篇文献右键选择“导出条目”格式选“BibTeX”。如果想在 Markdown 里获得更干净的纯文本也可以选择“CSL JSON”或直接复制“引用”信息。有一点要提醒BibTeX 并不能把摘要和笔记全都完整带出来如果有需要我会先把 Zotero 的笔记通过“打印/导出”功能导出成 HTML 或纯文本然后再做下一步。这样做的原因是 Codex 需要能读到你的笔记内容而不只是一条条干巴巴的题录信息。2.2 Codex 这边确认命令能跑通再谈流程Codex 的安装路径有好几种常见的是命令行工具方式。无论你用的是 Codex CLI 还是桌面版第一步都是确认几个基础项你有可用的 API Key或者能访问到当前项目对应的模型接口。本地网络能正常请求到 Codex 的 endpoint。很多人的“Codex 打不开”或“CC Switch 报错”都出在这一层。你确认自己用的是什么模型。有一个常见报错信息类似the gpt-5.6-sol model is not supported when using codex with a...这种情况通常不是 Codex 本体坏了而是当前账号、转发服务或调度工具里配置的模型名没有放通或者模型名本身不被 Codex 支持。如果你看到cc switch local proxy failed while handling codex endpoint /responses这类提示我的排查顺序是先确认代理配置是否指向了正确端口再确认接口地址能不能在浏览器里直接访问最后再看配置文件的 base_url 是否写错。不要一上来就重装软件。Codex 本身的核心用法是你给它一个自然语言任务它会根据当前目录下的文件或你粘贴的内容来写代码、执行命令、生成文本。所以在联动场景里我通常不是把 Codex 当成聊天窗口用而是让它作为“本地脚本助手”我在命令行里给它一段带上下文的任务描述它就能读取我当前目录下的文献清单文件、生成 Markdown 草稿或者写出一个批处理脚本。2.3 最稳妥的尝试路径从一条文献开始强烈建议第一次联动测试不要选四十几篇文献选 5 到 8 篇就够了。你先用这几篇跑通全流程看看生成结果是否准确再考虑扩展。这样做的原因是生成文本时上下文越长出错概率越高。尤其当你把摘要、笔记、引文信息都堆进去时Codex 可能会漏掉某一篇或者把两篇相近的文献混在一起。小样本验证能让你更快发现是输入格式问题还是模型理解问题。3. 一条可以复制的综述工作流从文献库到初稿我把这条流程叫做“三步提纯法”提取 → 结构化 → 生成。三个步骤里前两步需要你亲自做第三步才是让 Codex 来处理。3.1 提取把 Zotero 的条目变成能喂给模型的文本操作路径大概是在 Zotero 里选中你需要的一组文献。右键 → 导出条目选择 BibTeX 或者其他你习惯的格式。如果你的笔记也需要导出来先在 Zotero 里找到“笔记”视图复制为纯文本或者用 Better Notes 这类插件导出。然后你在本地新建一个文件夹把这些导出文件放进去。我一般用一个sources目录里面放sources/ ├── zotero_export.bib ├── notes.md └── prompt_review.txtnotes.md是你自己整理的每篇文献要点prompt_review.txt是给 Codex 的指令文件。这样做的目的是让 Codex 有一个固定的“输入口”它不需要去 Zotero 界面里乱翻只要读目录下的文件就行。3.2 结构化把几十篇文献提炼成一眼能看懂的清单这一步非常关键却很容易被跳过。如果你直接把 BibTeX 扔给 Codex它能读懂但“读懂”和“写好综述”是两回事。我建议你先用脚本或手动方式把每篇文献提炼成一个固定格式的条目类似### [1] Zhang et al. (2022) - 研究问题xxx - 方法xxx - 核心发现xxx - 与本综述主题的关系xxx只要每篇文献都能填上这四行Codex 就能很容易地把它们组织成段落。过去我会手动做这一步后来发现可以用 Codex 帮我把 BibTeX 里的信息转成这个清单只需要给它一个明确的示例。但这里有个矛盾如果 BibTeX 里的摘要本身不够清晰Codex 转出来的清单也会比较空。所以前置阅读还是绕不开。3.3 生成让 Codex 按照你的框架写初稿当你有了结构化的文献清单之后就可以写第一条真正的生成指令了。我给 Codex 的提示词一般包含四部分你的角色设定比如“你是一名文献综述写作助手”。文献清单内容。综述的主题和章节结构。生成规则例如每个段落必须引用条目 ID不允许虚构文献内容要指出文献之间的演变关系或矛盾点。一个简化版的示例你是一名文献综述写作助手。下面是围绕“xxx”主题的文献清单每条已经标好了条目 ID、研究问题、方法和核心发现。 请按照我提供的章节结构生成综述初稿 1. 开头说明该主题的重要性 2. 正文按照主题聚类每一段引用相关条目ID指出这些研究之间的共同点、差异和演进关系 3. 结尾指出当前研究空缺。 要求不得虚构清单中不存在的文献或结论每个关键判断必须标注对应的条目 ID。把这个提示词保存成一个文本文件在 Codex 里用类似这样的命令执行codex exec 请阅读 sources/ 目录下的文献清单和 notes.md然后根据 prompt_review.txt 里的要求生成综述初稿输出到 draft.md如果你是第一次使用 Codex CLI具体的命令写法可能因版本略有不同但总体逻辑是一致的。关键点在于不要把指令说得太空要把“读哪些文件、按什么结构输出、在哪里保存”都写清楚。3.4 生成之后你还要做一件事核对引文这一步不能省。Codex 生成完初稿后你要回到 Zotero 里检查每个引用条目是否真实存在。最常见的问题是它会自动补全一些看似合理的衔接句比如“近年来越来越多的研究开始关注xxx”这句没问题但如果它写“Zhang et al. (2022) 的研究证实了xxx”而 Zhang 不是做这个方向的那就必须改。对我来说把生成结果当成“一个条理清晰的草稿”而不是最终可交付的内容会舒服很多。草稿的价值是帮你节省了搭骨架和时间线的时间而不是帮你省掉核对文献的脑力劳动。4. 把经验沉淀成模板提示词和脚本比手敲更稳单次跑通流程之后你会发现一个更重要的价值这套流程可以反复用。你只需要换一批文献、换一个主题描述、换一下输出结构就能得到另一篇综述的初稿。这也是“效率提升十倍”真正能成立的地方——不是一次生成快而是重复使用时不用从头开始。4.1 为什么模板能大幅提高稳定性我见过不少人的做法是每次都在 Codex 里重新描述一遍需求写出来的提示词时好时坏。问题不在于 Codex 不稳定而在于输入不稳定。当你把提示词固定成一个文件把文献清单固定成统一格式把输出结构固定成模板生成质量自然就会稳定。我现在一般保存三类模板文献清单生成模板把 BibTeX 转成带条目 ID 的 Markdown 清单。综述初稿生成模板包括角色设定、章节结构、引用规则。检查清单模板生成后用来自查引用是否完整、格式是否统一、段落是否重复。这三类模板可以分别保存在你的模板目录里下次只需要替换其中的主题和文献部分其余不用动。4.2 先给目录再按需展开如果你发现自己给 Codex 一大段文献信息后它总是漏掉某些条目可以试试“先给目录再按需展开”的策略。也就是说第一次对话或第一条指令先让它生成大纲和每条文献的分组第二次再让它逐段生成每段只处理一组文献。这背后的逻辑是上下文过长时模型容易忽略中间部分的内容。按章节、按主题拆开处理既能降低出错率也方便你逐段修改。这个方法不仅适用于 Codex也适用于其他长文本生成类工具。4.3 把人工核查也做成模板我在 Zotero 里建了一个专门的“待核查”标签。每次用 Codex 生成完综述初稿我就把文中引用的条目列表导出来和 Zotero 里的真实条目做一次比对。一个可复用的检查清单包括作者和年份是否匹配。结论表述是否符合原文摘要。有没有出现文献清单之外的引用。段落之间的过渡句是否是模型自动补全的“软话”如果是考虑删掉。这些步骤看起来琐碎但真正让一篇综述“可信”的正是这些琐碎的地方。5. 边界和常见故障不是所有问题都能靠重启解决如果你在联动的过程中遇到问题不要先怀疑“是不是 Codex 太笨了”大多数情况是上游的文献信息、环境配置或输出格式出了问题。5.1 Zotero 最常见的几个坑很多人在用浏览器插件抓取文献时遇到“保存此条目时发生错误”这通常不是 Zotero 本身坏了而是翻译器没有及时更新。Zotero 的网页翻译器是从 GitHub 上拉取的如果你长时间没有更新网站的 DOM 结构一变翻译器就会失效。排查顺序是打开 Zotero 的“设置 → 高级”更新翻译器。再试试重新抓取。如果还是不行手动把网页上的标题、作者、摘要粘贴到一个新建条目里暂时不依赖自动翻译器。另一个常见问题是 Edge 浏览器里装好了 Zotero Connector但点击保存后没有反应。大多数情况下是插件权限问题进入浏览器扩展管理页允许 Zotero Connector 访问你需要的网站刷新页面再试。如果还不行卸载重装插件是一个有效方法因为浏览器插件偶尔会出现本地存储状态异常。还有人会问Zotero 在 Word 里插入文献后如何实现跳转超链接这取决于你用的是 Zotero 的 Word 插件还是手动插入的引用文本。如果是 Word 插件生成的引文点击目录或引文本身就可以跳转到文末参考文献列表前提是文档中没有被手动破坏域代码。如果出现无法跳转一般是 Word 里“显示域代码”模式被打开了关闭后就能恢复正常。5.2 Codex 这边的故障排查顺序Codex 安装、打不开、登录不了、模型不支持这些关键词在提问里出现得很多。我建议按这个顺序排查先看官方文档里的系统要求。是否支持你的操作系统是否需要特定版本的 Node.js 或运行时。再看网络。Codex 需要访问它的服务端点如果你的本地网络需要代理就要确认代理配置正确。比如前面提到的cc switch local proxy failed while handling codex endpoint /responses基本都出在这一层。再看模型名。如果你配置的模型名和你当前账号能访问的模型不一致会出现模型不支持的报错。一个稳妥做法是先在官方示例里跑通默认配置再修改模型名。最后看文件路径。如果你在某个项目目录里运行 Codex但它读不到你放在sources/下的文件检查一下你是不是在错误的工作目录里启动的。如果你看到“Codex 打不开”这类问题建议先去看终端的日志而不是反复重装。日志里通常会给出具体是端口被占用、认证失败还是网络连接失败。5.3 适合谁、不适合谁这条工作流适合以下人群已经有一定文献阅读量Zotero 里有几十篇相关文献但缺乏组织能力的人。需要经常处理“从文献到综述”或“从文献到开题报告”这类重复场景的研究生和科研人员。愿意学习基本的命令行操作和文件管理而不是只想要一个网页版聊天框的人。不适合以下人群只想把几十篇 PDF 丢给 AI什么都不读就想生成准确综述的人。这条工作流救不了这种情况。完全不想做人工核对的人。Codex 生成的初稿永远只是初稿引用信息必须人工验证。文献量非常小的人。如果只有三五篇你直接阅读和写可能反而更快。6. 真正的效率不是“一句话”而是工作流回到标题说的“一句话就可以写完一篇文献综述”。经过前面这些过程你应该已经能理解了——一句话生成综述的能力确实存在但它依赖的是你之前已经完成的大量整理工作。Codex 和 Zotero 联动的本质是把“文献管理的结构化能力”和“文本生成的组织能力”合并到一条流水线上让“整理”和“生成”这两个环节不再脱节。所以我的建议是不要追求“一句话”这个表面效果而是追求“每篇文献都有结构化的要点、每条引文都能溯源、输出格式可以复用”这个底层的稳定能力。当你把这套流程跑通之后每周遇到新的文献综述需求你只需要更新文献清单修改提示词里的主题描述就能在十几分钟内得到一版质量不错的初稿。剩下的事情依然是你的阅读、判断和修改。这也是我认为 Codex 和 Zotero 联动真正值得尝试的原因。它不是在帮你骗自己说论文已经写完了而是在帮你把最机械、最耗时、最容易出错的整理和成稿环节交出去让你能把精力放在真正属于研究者的那一部分——理解文献到底说了什么以及它们之间到底有什么关系。那一部分任何模型都无法替你做但有了好的流程你会比过去做得更快也更从容。