开学季
AI 研究助手 — 新学期读论文、写综述快 10 倍月付 ¥25 起 · 终身 ¥139
查看价格 →

Zotero 10 插件兼容指南：哪些能用、哪些坏了、怎么修复

Zotero 10 已于 2026 年 8 月 17 日正式发布。 对大多数人来说，升级后的第一个问题不是"有什么新功能"，而是——我装的插件还能用吗？

这个问题问得对。一个没有插件的 Zotero，就像一个没有扩展的浏览器：核心功能还在，但你的工作流已经没了一半。好消息是：截至 2026 年 9 月初，几乎所有主流插件都已经发布了兼容 Zotero 10 的版本。 整个插件生态在 8 月下旬到 9 月初分几波完成了更新，大多数知名插件在 Zotero 10 发布后一到两周内就推出了新版。

下面这份指南包含：大家真正在用的插件的当前兼容状态、升级前检查自己插件库的清单，以及插件真的坏了之后的逐步修复方法。

Zotero 10 插件兼容状态（2026 年 9 月）

我们核对了最热门 Zotero 插件截至 2026 年 9 月 8 日的发布动态。标 ✅ 已兼容 Zotero 10 的代表已经发布了兼容版本；标 ⚠️ 需要确认 的代表更新较慢或还没发布 Zotero 10 版本——升级前请到它的发布页核实。

阅读、翻译与 PDF 工具

  • ✅ zotero-pdf-translate —— 在 Zotero 内直接翻译 PDF、EPUB 和笔记注释。已发布 Zotero 10 版本。
  • ✅ Zotero PDF2ZH（zotero-pdf2zh） —— 保留排版的中英双语 PDF 翻译。已发布 Zotero 10 版本。
  • ✅ PDFMathTranslate —— 保留公式的科学论文翻译工具。Zotero 10 发布窗口期内持续更新。
  • ✅ zotero-scihub —— 自动下载论文 PDF。已更新兼容 Zotero 10。

笔记、Obsidian 与知识管理

  • ✅ zotero-better-notes —— 功能最全的笔记管理插件。已发布 Zotero 10 版本。
  • ✅ zotero-mdnotes —— 把笔记和元数据导出为 Markdown/Obsidian。已更新。
  • ✅ Notero —— 把条目和笔记同步到 Notion。已更新。
  • ⚠️ Obsidian 生态的小型桥接/URI 插件 —— 大部分可用，但个别小插件更新较慢，请逐个到发布页确认。

AI 与科研助手

  • ✅ PapersGPT —— AI 对话、AutoPilot 批量精读、Zotero MCP 服务器。完全兼容 Zotero 10（这是我们的插件，Zotero 每次大版本我们都会第一时间跟进）。
  • ✅ Zotero GPT —— 用自己的 API Key 和文献库对话。已发布 Zotero 10 版本。
  • ✅ llm-for-zotero —— 扎根在你文献库里的开源科研 agent。已更新。
  • ✅ Zotero AI Butler（AI 管家） —— 批量精读文献并写入结构化 Zotero 笔记。已发布 Zotero 10 版本。
  • ✅ zotero-mcp —— 把文献库接入 Claude、Codex 等 MCP 客户端。已更新。
  • ✅ zotero-arxiv-daily —— 根据你的文献库每天推荐 arXiv 新论文。已更新。
  • ⚠️ Aria（AI 科研助手） —— 8 月时仍停留在旧版兼容，升级前请先看它的发布页。

中文用户（元数据与翻译）

  • ✅ Jasminum（小金刚） —— CNKI 知网等中文元数据抓取。已发布 Zotero 10 版本。
  • ✅ translators_CN —— 中文网页抓取翻译器。已更新。
  • ✅ zotero-pdf2zh —— 见上文。

引用、LaTeX 与参考文献

  • ✅ zotero-better-bibtex —— LaTeX/Overleaf 用户必备。已发布 Zotero 10 版本。
  • ✅ zotero-shortdoi —— DOI 抓取与校验。已更新。
  • ✅ zotero-reference —— PDF 参考文献面板。已更新。
  • ✅ zotero-citation —— 更清爽的 Word 引文体验。已更新。

附件、文件与工作流

  • ✅ ZotFile —— 附件自动重命名与管理。已更新。
  • ✅ zotero-attanger —— 附件整理助手。已更新。
  • ✅ zotero-actions-tags —— 工作流自动化。已更新。
  • ✅ zotmoov 等"监视文件夹"类插件 —— 已有兼容 Zotero 10 的版本。

主题与界面

  • ✅ Ethereal Style —— 广受欢迎的暗色主题美化。已发布 Zotero 10 版本。
  • ✅ zotero-night —— 夜间主题。已更新。

插件安装这件事本身也在变

  • ✅ Zotero Add-ons Market（社区版应用内插件市场）—— 已更新兼容 Zotero 10。与此同时，Zotero 中文社区著名的网页版插件合集已宣布暂停维护，越来越多用户转向应用内市场，下文细说。

以上状态对应我们截至 2026 年 9 月 8 日核实到的发布动态。如果你依赖的插件不在列表里，别猜——去它的 GitHub Releases 页或论坛帖里找 2026 年 8 月 17 日之后发布的版本。

升级前：3 分钟兼容自查

在点"检查更新"之前做完下面这 5 步，能避开 90% 的升级烦恼：

  1. 列出你的插件。 打开 Zotero → 工具 → 附加组件，记下（或截图）每个插件和它的版本号。
  2. 逐个查发布页。 对每一个你离不开的插件，打开它的 GitHub Releases 页（或官方论坛帖），找发布日期在 2026 年 8 月 17 日当天或之后的版本——这就是兼容 Zotero 10 的信号。很多作者还会在更新说明里直接写 "Zotero 10" 或 "10.0"。
  3. 先更新插件，再升级 Zotero。 如果兼容版本已发布，在升级 Zotero 本体之前先装好它。升级时 Zotero 会保留你的插件目录，已经是新版的插件通常能安然度过升级。
  4. 备份数据。 Zotero 的所有数据都在数据目录里（macOS/Linux 默认 ~/Zotero；Windows 在 %APPDATA%\Zotero\Zotero\Profiles\… 下——除非你在设置 → 高级 → 文件和文件夹里改过位置）。先复制一份到安全的地方：现在花五分钟，好过之后用一个周末来抢救。注意：Zotero 账号同步不等于备份，没有开启文件同步的话本地附件并不在云端。
  5. 升级后复查附加组件。 Zotero 更新完成后，打开工具 → 附加组件确认没有插件被标记为"不兼容"或已禁用，然后重启一次 Zotero——大版本升级后很多插件需要一次干净的重启。

在 Zotero 10 里安装 / 更新插件

Zotero 10 沿用 Zotero 7 以来的现代插件系统（不再支持把 XPI 拖进主窗口那种老办法）：

  1. 下载插件的 .xpi 文件。 到插件 GitHub Releases 页，下载 release 附件里的 .xpi（别下源码压缩包）。
  2. 安装： 工具 → 附加组件 → ⚙ 齿轮图标 → 从文件安装附加组件… → 选中 .xpi。
  3. 按提示重启 Zotero。

想要应用商店式的体验？ 先装一次社区插件 Zotero Add-ons Market，之后就能在 Zotero 内部浏览、安装、更新插件——包括查看你的哪些插件出了 Zotero 10 兼容新版。随着网页版目录逐渐退场（Zotero 中文社区那个著名的插件合集已经暂停维护），应用内市场正在成为保持插件最新的最快途径。

更新已安装的插件：用新版 .xpi 重复一次安装步骤即可（会干净覆盖），或者在有更新按钮时直接用 Add-ons Market 更新。

插件坏了怎么办：从易到难的排查阶梯

即使准备充分，也可能出问题。按下面顺序排查，从最轻的招数开始：

症状：插件在"工具 → 附加组件"里显示"不兼容"或已被禁用。

  • 先去它的发布页再看一眼——修复版本可能今天刚发。Zotero 9 之后作者们持续更新了好几周，Zotero 10 这次也一样。
  • 安装最新的 .xpi 并重启 Zotero。
  • 如果附加组件管理器拒绝安装，说明当前 Zotero 版本还没被该插件声明支持——别强行装，等作者更新（或看下文最后一段）。

症状：插件能启用但行为异常（工具栏按钮消失、设置项没了、加载报错）。

  • 先重启一次 Zotero。
  • 打开帮助 → 调试输出日志（或从帮助菜单打开 Zotero 错误控制台），复现问题，在日志里找包含插件名字的报错——它能精确告诉你哪个插件在出错。
  • 去插件的 GitHub Issues 页看看。兼容更新潮期间，你的 bug 通常已经有人报过了，作者往往会在正式发布前先在 issue 里贴出修复版。
  • 如果是你不常用的小插件，直接在工具 → 附加组件里禁用它继续干活，等作者跟上再启用。

症状：升级后 Zotero 本身变卡或崩溃。

  • 分批禁用插件（一次一半），隔离出罪魁祸首。
  • 对可疑插件，先"移除"再重新安装，而不只是禁用——有时过期的偏好文件会跟着旧版本残留下来。

症状：你答辩要用的插件迟迟没有 Zotero 10 版本。

  • 先想清楚：你现在真的需要升级到 Zotero 10 吗？没有任何力量逼你在新版本发布当天就升级。 Zotero 9 可以继续正常跑你现有的插件——先升插件、后升 Zotero，或者反过来，哪个顺序能让工作流不断档就用哪个。
  • 在插件作者的 GitHub 上礼貌地发一个 issue（一句"在等 Zotero 10 支持，辛苦了"真的能帮忙排优先级）。
  • 关注作者的发布页，版本一出来就升级。

跳出版本旋涡：AI 层应该"住在"文献库里，而不是"挂在"界面上

过去 18 个月你已经见过三次这个剧本——Zotero 8、9、10：每次大版本都很好，每次大版本也都会短暂地弄坏一批插件。活得最好的，是社区够大、或者团队紧贴 Zotero 发布节奏的那些插件。

选科研 AI 助手时记住这一点很有用。一个只跟你的文献库"对话"的 AI 插件（索引你的 PDF、通过 Zotero 自己的存储读文件），比一个深挖 Zotero 界面钩子的插件坏得少得多——而且新版本发布时，它应该已经备好兼容版。PapersGPT 就是这么设计的：索引文献库、和 PDF 对话、AutoPilot 批量精读，Zotero 10 发布当周就已兼容。如果你不想把阅读工作流押在下一次兼容潮上，这正是你想要的插件类型。

常见问题

我的 Zotero 插件兼容 Zotero 10 吗？ 大多数都兼容（截至 2026 年 9 月）。zotero-pdf-translate、better-bibtex、zotero-gpt、better-notes、Jasminum、Ethereal Style 等主流插件都在 Zotero 10（8 月 17 日）发布后几天到几周内推出了兼容版本。某个具体插件是否兼容，去它的 GitHub Releases 页找 2026 年 8 月 17 日之后发布的版本即可。

怎么把插件更新到兼容 Zotero 10？ 去插件 GitHub Releases 页下载最新 .xpi，打开 工具 → 附加组件 → ⚙ → 从文件安装附加组件… 选中文件，然后重启 Zotero。或者装社区插件 Zotero Add-ons Market，在 Zotero 内部直接浏览和更新。

升级 Zotero 10 后插件坏了怎么办？ 先重启 Zotero，再去插件发布页看有没有更新版（9 月上旬兼容更新仍在陆续发布）。如果还没有，就禁用该插件等作者更新；也可以看它的 GitHub Issues，作者通常会先在 issue 里贴出修复版。

Zotero 10 里能手动安装插件吗？ 可以——上面的 .xpi 流程就是手动安装。Zotero 6 时代把 XPI 拖进主窗口的装法已经失效，请用"工具 → 附加组件 → 从文件安装附加组件"。

PapersGPT 兼容 Zotero 10 吗？ 兼容。PapersGPT 完全支持 Zotero 10，也支持 7、8、9——包括 AutoPilot 批量精读 和 Zotero MCP 服务器 功能。

有个插件我离不开但还没更新，我能留在旧版 Zotero 吗？ 可以——你不必在新版本发布当天就升级。Zotero 9 会继续正常工作，插件声明支持哪个版本就用哪个版本。先把关键插件升好、再升 Zotero，按让自己工作流不断档的顺序来。

在 Zotero 10 上开始阅读你的文献库

Zotero 10 的 Reading Mode 和更快的搜索让它成为迄今最好用的版本——而插件生态已经跟上，现在正是升级的好时机。下载 PapersGPT for Zotero，和你的 PDF 对话、自动总结新论文、基于自己的文献库起草文献综述。免费开始，今天就兼容 Zotero 10。