syt2/zotero-addons · 上手攻略

  • 仓库：syt2/zotero-addons
  • 链接：https://github.com/syt2/zotero-addons
  • 分类：zotero · plugin · academic-tooling
  • 作者：Tom
  • 更新：2026-08-10

是什么

zotero-addons 是一个Zotero 插件（不是独立软件），用于在 Zotero 内部直接浏览、安装、搜索和评论 Zotero 插件（add-ons）。它将 Zotero 插件生态系统的核心数据（syt2/zotero-addons-scraper 爬取 + zotero-chinese 社区维护）做成一个内置插件市场界面，省去用户手动去 GitHub / Zotero forum 找插件的麻烦。

核心功能：插件搜索、插件详情查看、一键安装更新、插件评论区、数据源切换。

解决什么问题

Zotero 用户扩展功能主要依赖社区插件，但找插件的体验长期很割裂： - 插件分散在 GitHub、Zotero Forum、不同博客之间，没有统一的发现入口 - 更新插件需要手动去各个页面下载 xpi 文件 - 国内用户访问 Zotero 官方插件论坛经常遇到加载慢或空白问题 - 插件质量参差不齐，没有社区评分参考

zotero-addons 将这个流程内嵌到 Zotero 主界面：搜索 → 看评价 → 直接安装，一条路走完。

快速安装

方式一：直接下载 xpi 安装（推荐）

# 1. 下载最新版 xpi
# https://github.com/syt2/zotero-addons/releases/latest/download/zotero-addons.xpi

# 2. Zotero 内安装
# 菜单栏：工具 → 附加组件（或插件）→ 齿轮图标 → "Install Add-on From File..."
# 选择下载的 xpi 文件

# 3. 重启 Zotero

方式二：GitHub 手动安装

# 克隆仓库（不推荐，xpi 方式更简单）
git clone https://github.com/syt2/zotero-addons.git
# 然后在 Zotero 内通过 xpi 安装

⚠️ 安装完成后在 Zotero 菜单栏找到插件图标（工具栏中），点击图标进入插件市场界面。

核心用法

安装后首次使用

  1. 安装完成并重启 Zotero
  2. 点击工具栏的插件图标（一个橙色/灰色方块图标）
  3. 或通过菜单：工具 → 插件市场
  4. 首次使用建议在设置中切换数据源为"自动源"，插件会自动选择可连接的数据源

数据源切换（国内用户重点）

在插件市场界面右上角可以切换数据源：

数据源 说明
自动源 默认推荐，自动检测可连接的源
插件爬虫（syt2/zotero-addons-scraper） 主数据源，插件最全
Zotero 中文社区（zotero-chinese/zotero-plugins） 国内友好，部分中文插件
自定义源 任何符合 zotero-chinese 格式的 JSON API 地址

国内用户若遇到插件列表空白，先切换"自动源"，再依次尝试"插件爬虫"和"Zotero 中文社区"。

提交新插件到数据源

如果你发现一个好用的 Zotero 插件想让更多人发现： - 提交到 syt2/zotero-addons-scraper：自动化爬取插件页面数据 - 或提交到 zotero-chinese/zotero-plugins：中文社区维护的插件列表

自定义数据源格式参考 zotero-chinese 仓库的 JSON schema。

与 Zotero-Better-BibTeX 的配合

zotero-addons 主要做插件市场功能，引用管理推荐配合使用： - Zotero-Better-BibTeX：更好的 BibTeX 导出、Citekey 自动生成 - Zotero Citation Counts：自动抓取引用数 - 可以在 zotero-addons 的插件市场里直接搜索安装这些插件

典型适用场景

场景 使用方式
发现新 Zotero 插件 在插件市场搜索功能里输入关键词（PDF、BibTeX、翻译等）
批量更新插件 在插件市场查看所有已安装插件，一键更新
评估插件质量 查看插件评分和评论区，了解其他用户的使用体验
国内网络环境 切换到"Zotero 中文社区"数据源，避免访问外网插件站点的速度问题
插件开发参考 参考 windingwind/zotero-plugin-template 开发自己的插件

坑与注意

  1. 这是 Zotero 插件，不是独立软件：安装前提是已经装有 Zotero（https://www.zotero.org），没有 Zotero 主程序无法运行

  2. xpi 安装需要 Zotero 重启：安装 xpi 后必须完全退出并重启 Zotero（包括后台进程），否则插件不会生效

  3. 插件市场数据源依赖网络：如果数据源（GitHub/scraper API）不可达，插件市场会显示空白；国内用户务必尝试切换"Zotero 中文社区"数据源

  4. 插件权限提示：安装 Zotero 插件时会提示需要授权的权限范围，zotero-addons 本身需要网络访问权限来获取插件列表

  5. 插件兼容性：部分插件可能与 Zotero 最新版本不兼容；安装前看评论区的兼容性备注

  6. xpi 下载源：不要从非 GitHub Releases 的地址下载 xpi，避免安全风险；Releases 页面：https://github.com/syt2/zotero-addons/releases/latest

  7. 更新频率：插件数据库由 scraper 定时爬取，更新可能有延迟；最新发布的插件不一定立即出现在市场里

与同类对比

维度 zotero-addons Zotero Forum 手动查找 Zotero Plugin Hub（第三方） 各类博客推荐
发现入口 Zotero 内直接搜索 需要浏览器访问论坛 需打开独立网站 依赖偶然看到博客
安装方式 插件内一键安装 手动下载 xpi 手动下载 xpi 手动下载 xpi
评价信息 ✅ 用户评论区 ✅ Forum 帖子 ❌ ❌
数据源 GitHub scraper + 中文社区 官方 Forum 人工维护列表 无结构化数据
插件数量 scraper 自动覆盖 人工发帖数量有限 人工维护有限 随机
国内可用性 ✅（可切换中文社区源） ❌ 经常访问慢或 403 ✅ ✅

zotero-addons 是 Zotero 插件生态中目前最方便的发现 + 安装一体化工具，尤其对国内用户价值明显（中文社区数据源 + 无需翻墙）。

一句话推荐结论

每个重度 Zotero 用户都应该装 zotero-addons——插件市场的发现效率比满网找 xpi 高太多，国内用户切换中文社区源后体验尤为流畅，是那种"用之前不觉得需要，用之后离不开"的小工具。

原始链接： - 仓库：https://github.com/syt2/zotero-addons - 最新 xpi：https://github.com/syt2/zotero-addons/releases/latest/download/zotero-addons.xpi - 数据源爬虫：https://github.com/syt2/zotero-addons-scraper - 中文社区插件：https://github.com/zotero-chinese/zotero-plugins - Zotero 主站：https://www.zotero.org - 插件开发模板：https://github.com/windingwind/zotero-plugin-template