Zotero plugin 怎么选?插件分类、兼容性与 XPI 安装指南
简答:Zotero plugin 没有一份由 Zotero 官方维护的完整推荐清单,选择时应先按任务分流,再核对插件发布页的 Zotero 主版本支持、最近维护、外部服务和权限说明。当前 Zotero 官方版本记录显示 10.0.7 于 2026 年 10 月 29 日发布;安装插件前先备份数据目录,再下载真正的 .xpi 文件,通过 Tools → Plugins 安装。
定义:Zotero plugin 是社区开发、以 .xpi 文件分发的桌面扩展,用于增强笔记、PDF、元数据、引用或自动化功能;它不同于 Zotero 内置功能、浏览器 Connector 以及随 Zotero 提供的 Word、LibreOffice 和 Google Docs 集成。
先按需求选:你真正需要的是哪一类 Zotero plugin?
搜索“zotero plugin”的用户通常有两种需求:一是想找能解决具体问题的插件,二是已经下载了插件但不知道如何安装或判断兼容性。先不要按“热门”或下载量直接选择,建议先确认任务属于笔记、引用、PDF、翻译、同步还是自动化。
| 需求 | 可优先了解的工具 | 适合什么人 | 安装前重点核验 |
|---|---|---|---|
| 扩展笔记、双向链接、Markdown 或批量导出 | Better Notes | 需要在 Zotero 内整理笔记、模板、链接或导出的人 | 发布页是否支持当前 Zotero;Markdown 同步是否符合自己的文件结构 |
| 稳定引用键、BibTeX/BibLaTeX 导出、自动导出 | Better BibTeX | 使用 LaTeX、Markdown 或文本化写作流程的人 | 该项目说明 Zotero 7 已不再获得后续支持;Zotero 8 以后还涉及原生 citation key 迁移 |
| PDF、网页、摘要、批注翻译 | Translate for Zotero | 需要在阅读器中翻译选中文本、标题、摘要或注释的人 | 翻译服务类型、访问方式、API 密钥和数据是否发送到外部服务 |
| 标签、事件触发、批量操作和脚本化流程 | Actions & Tags | 愿意配置规则或脚本、希望减少重复操作的人 | 脚本来源、触发范围、是否会批量修改条目,以及当前版本支持范围 |
| Word、LibreOffice 或 Google Docs 引用 | Zotero 原生集成 | 只想在文稿中插入引用和自动生成参考文献的人 | 通常不需要另装普通 XPI 插件,应先检查 Zotero 的 Cite → Word Processors 设置 |
| 网页保存文献 | Zotero Connector | 需要从浏览器抓取网页、论文或书目信息的人 | 按浏览器扩展流程安装,不要把 Connector 当作桌面 XPI 插件 |
插件名称和兼容性会随发布变化。Zotero 官方明确说明,社区插件并没有一份完整的官方目录,而且插件拥有访问 Zotero 和计算机的权限;因此,下面的工具只作为按任务筛选的公开资料示例,不等同于官方背书。可先查看 Zotero 官方插件说明,再打开具体项目的发布页核验。
具体插件怎么比较:功能、维护与隐私要分开看
下表只列出本次核验到公开资料能够支持的内容。版本号是发布页面当前显示的版本或项目说明中的兼容信息,不代表所有操作系统和所有 Zotero 版本都能正常工作。安装前仍应以插件发布页为准。
| 插件 | 公开资料能确认的主要用途 | 兼容性线索 | 维护状态线索 | 隐私与学习成本 |
|---|---|---|---|---|
| Better Notes | 笔记编辑、笔记链接、模板、Markdown 同步、笔记导出和工作流 | 发布页当前列出 v3.3.3,但需继续查看该版本的支持范围 | 公开仓库显示有持续提交和发布记录 | 基础笔记功能学习成本中等;使用 Markdown 同步或外部 AI 服务时,需单独阅读数据处理说明 |
| Better BibTeX | 引用键生成、BibTeX/BibLaTeX 导出、自动导出和文本写作流程 | 项目说明明确写出 Zotero 7 不再获得后续支持;Zotero 8 以后使用原生 citation key,并可能触发迁移 | 公开仓库和发布页仍有版本与问题记录 | 主要处理书目数据;配置项较多,适合能接受迁移和导出排错的用户 |
| Translate for Zotero | 翻译 PDF、EPUB、网页、元数据、注释和笔记,支持多个翻译服务 | README 显示 Zotero 7/8 标识,发布记录又提到支持 Zotero 10,公开资料存在差异,应以实际发行包和测试结果为准 | 发布页显示 v2.4.8,并持续记录功能和修复变化 | 隐私取决于所选翻译服务;使用外部 API 时可能涉及文本、令牌或请求日志,不能默认视为纯本地处理 |
| Actions & Tags | 自动加标签、事件触发、复制链接、自动生成笔记和自定义脚本 | 发布记录包含针对 Zotero 10 的修复和版本上限调整 | 发布页显示 v2.6.1,并有 Zotero 10 相关修复说明 | 学习成本高于普通功能插件;脚本可能批量修改资料,应先在副本库试运行 |
Better Notes 的功能说明可在其公开仓库查看,Better BibTeX 的兼容性和 citation key 迁移说明见项目 README,Translate for Zotero 的功能和安装方式见项目 README,Actions & Tags 的 Zotero 10 修复见其发布页:Better Notes 项目说明、Better BibTeX 项目说明、Translate for Zotero 项目说明、Actions & Tags 发布记录。
安装前先核验 Zotero 版本、插件文件和外部依赖
- 确认 Zotero 主版本。打开 Zotero 的 Help → About Zotero;macOS 可从 Zotero 菜单进入 About Zotero。记录完整主版本,例如 10.x,再打开插件的 Releases 或安装说明,寻找明确的支持范围。
- 先检查原生功能。如果目标是 Word、LibreOffice 或 Google Docs 引用,不要先下载社区插件。Zotero 官方说明,这些文字处理集成随 Zotero 提供,并可从 Cite → Word Processors 重新安装。Word Processor Plugins 官方说明
- 下载 .xpi 而不是源码压缩包。在项目 Releases 页面寻找以
.xpi结尾的发布文件。GitHub 的 Source code (zip) 是源码,不能通过改后缀直接变成可安装插件。 - 确认是否依赖外部服务。翻译、AI、同步和自动化工具可能需要 API、外部服务器或额外脚本。只有项目文档明确说明时,才能判断数据是否本地处理。
- 保留回退路径。记录当前已安装插件、版本和配置;首次安装或升级不要直接在唯一工作库上批量执行。
截至 2026 年 10 月 31 日,Zotero 官方版本记录显示 10.0.7 于 2026 年 10 月 29 日发布,并包含多项插件相关修复。这个事实只能说明 Zotero 本身的版本记录,不能推出某个社区插件已经兼容 Zotero 10;插件兼容性仍要逐个核验。Zotero 版本记录
Zotero plugin 的 XPI 安装步骤:Windows、macOS、Linux 通用
- 从可信开发者的发布页下载
.xpi文件,并将文件保存到本地。使用 Firefox 时,建议右键选择“另存为”,避免浏览器直接打开文件。 - 启动 Zotero,打开
Tools → Plugins。某些版本或插件文档可能显示为Tools → Add-ons,以当前界面为准。 - 在插件管理窗口点击右上角齿轮,选择
Install Plugin From File或Install Add-on from file。 - 选择本地的
.xpi文件,确认安装。若出现重启提示,保存工作后重启 Zotero。 - 重启后回到插件列表,检查插件是否启用,再到 Tools、Settings、PDF 阅读器或笔记窗口寻找新增入口。
- 先用一条测试文献验证:能否打开菜单、读取附件、写入笔记、生成引用或完成导出;确认无误后再用于完整资料库。
Zotero 官方给出的基础方式是下载 XPI 后拖入 Plugins 窗口;具体插件的菜单名称可能不同。Better Notes、Translate for Zotero 和 Actions & Tags 的项目说明也都要求先下载 XPI,再从插件管理窗口安装。Zotero XPI 安装说明
安装失败怎么排查:先处理文件和兼容性,再看网络
| 现象 | 优先检查 | 处理方式 |
|---|---|---|
| 提示不兼容 | Zotero 主版本与插件支持范围 | 回到插件发布页寻找对应版本;不要直接修改兼容字段绕过检查。若没有兼容版本,停留在当前稳定插件或寻找替代工具。 |
| 提示文件损坏 | 是否下载了 Source code (zip)、错误页面或不完整文件 | 删除现有文件,重新从 Releases 下载真正的 XPI;不要把 ZIP 重命名为 XPI。 |
| 拖入没有反应 | 窗口位置、文件扩展名和下载是否完成 | 改用齿轮菜单的 Install Plugin From File,确认 Zotero 已正常启动。 |
| 安装后没有入口 | 是否需要重启、插件是否被停用、入口是否在 Settings 或 PDF 阅读器 | 重启并检查插件状态,再查看项目 README 的使用说明。 |
| 升级 Zotero 后崩溃或同步异常 | 最近升级的插件和 Zotero 版本变化 | 启动后先停用最近安装或升级的插件;若恢复正常,再查看插件 issue、发布说明和兼容版本。 |
| 下载中断或发布页打不开 | 本地网络、DNS、代理、浏览器下载策略或源站 | 先确认普通网页和其他文件是否能下载,再检查 DNS、代理和 MTU;不要为了绕过下载问题从不明镜像获取 XPI。 |
网络排查应放在“下载失败”这一分支,而不是所有插件故障的第一步。多数安装问题应先排除错误文件、版本不兼容、未重启、插件被停用和入口位置变化。
备份、停用和卸载:给插件准备可恢复的测试环境
插件可能修改条目、笔记、附件路径或导出结果。Zotero 官方建议备份整个数据目录,而不是只导出 BibTeX、RIS 或 RDF,因为导出再导入并不能产生完全相同的资料库。
- 在 Zotero 设置的 Advanced 页面点击
Show Data Directory,找到当前正在使用的数据目录。 - 彻底退出 Zotero 后,再复制整个数据目录到另一块磁盘或备份位置。重点包括
zotero.sqlite、storage和其他子目录。 - 首次测试插件时,使用少量条目或副本库,尤其是会批量加标签、改字段、生成笔记或处理 PDF 的插件。
- 出现异常时进入 Tools → Plugins,先 Disable 最近安装的插件,确认 Zotero 是否恢复。
- 确认问题由插件引起后,再选择 Remove;卸载后重启并检查条目、附件、笔记和同步状态。
复制数据目录前必须关闭 Zotero,否则可能复制到未完成写入的数据库文件。完整备份和恢复方法以 Zotero 数据目录官方说明为准。
哪些情况不必安装插件?
- Word、LibreOffice 和 Google Docs 引用:优先使用 Zotero 自带的文字处理集成,缺失时从 Cite → Word Processors 重新安装。
- 网页采集:使用对应浏览器的 Zotero Connector,而不是桌面插件安装流程。
- 引用样式:先在 Zotero 的 Cite 设置中安装或切换 CSL 样式,不要为了一个样式安装大型工作流插件。
- 全文搜索:先检查附件是否存在文本层、Zotero 是否完成索引,以及当前版本的搜索设置;Zotero 10 已经增强了全文搜索和附件索引能力。
- 基础标签和集合管理:先使用 Zotero 原生的标签、集合、保存的搜索和批量编辑功能,只有原生功能确实不够时再加插件。
插件越多,升级后逐个排查的成本通常越高。更稳妥的做法是“一次只安装一个、先测试再长期使用”,并为有外部服务或批量修改能力的插件单独保留配置记录。
常见问题
Zotero plugin 应该从哪里下载?
优先从插件开发者的公开项目主页或 Releases 页面下载,并确认文件确实以 .xpi 结尾。Zotero 官方没有一份完整的官方插件目录,因此不要把搜索结果中的任意下载页都视为可信来源。
Zotero plugin 安装入口在哪里?
通常打开 Tools → Plugins,在插件窗口右上角点击齿轮,选择 Install Plugin From File,然后选择本地 XPI 文件。部分版本或项目文档可能显示为 Tools → Add-ons,菜单名称以当前版本为准。
Zotero 10 能安装所有 Zotero plugin 吗?
不能直接这样判断。Zotero 官方版本记录显示 10.0.7 已于 2026 年 10 月 29 日发布,但每个社区插件仍需单独查看发布页。部分插件已经记录 Zotero 10 修复,另一些项目的公开兼容标识可能较旧或存在差异。
Better BibTeX 还能用于 Zotero 7 吗?
项目公开说明写明,Zotero 7 不再获得 Better BibTeX 的后续支持;较早版本可能仍能运行,但不应把“能运行”理解为继续获得更新。使用 Zotero 8 或更高版本时,还要注意原生 citation key 与旧数据迁移。
Word 引用需要另外安装 Zotero plugin 吗?
通常不需要按普通 XPI 插件安装。Word、LibreOffice 和 Google Docs 集成随 Zotero 提供;如果 Word 中没有 Zotero 工具栏,可先到 Zotero 的 Cite → Word Processors 重新安装,并按官方排障文档处理。
安装插件前一定要备份吗?
涉及批量改字段、标签、笔记、附件或 PDF 的插件,建议先备份整个 Zotero 数据目录,并在少量条目或副本库上测试。只导出 BibTeX、RIS 或 RDF 不能替代完整数据备份。
插件下载失败是网络问题还是插件问题?
先检查是否下载成了网页、源码 ZIP 或不完整文件,再核对 Zotero 版本和插件发布页。只有在普通网页和其他文件也无法下载时,才进一步排查 DNS、代理、MTU 或网络连接。
相关阅读
参考资料
- Plugins for Zotero | Zotero Documentation
- Zotero Version History | Zotero Documentation
- The Zotero Data Directory | Zotero Documentation
- Word Processor Plugins | Zotero Documentation
- Better Notes for Zotero | GitHub
- Better BibTeX for Zotero | GitHub
- Translate for Zotero | GitHub
- Actions & Tags Releases | GitHub