告别复杂配置：Zotero插件市场3分钟极速上手指南

核心价值：为什么选择这款工具？

当你还在为Zotero插件安装四处找链接、手动拖放XPI文件时，这款插件市场工具已经帮全球数万研究者解决了插件管理的3大痛点：

💡 一站式插件中心：告别浏览器搜索→下载→拖拽安装的繁琐流程，所有操作在Zotero内完成
💡 自动兼容性检测：橙色高亮显示⚠️标记的插件会智能匹配你的Zotero版本（支持98%的主流插件格式）
💡 多源管理自由：不仅能获取官方插件，还支持自定义数据源URL，学术团队可搭建私有插件库

3分钟快速体验

场景：5步安装PDF翻译插件

1️⃣ 打开Zotero→点击工具栏「插件市场」图标
2️⃣ 在搜索框输入「翻译」关键词
3️⃣ 找到带✅标记的「PDF Translator」插件
4️⃣ 点击「安装」按钮并等待进度条完成
5️⃣ 重启Zotero后右键点击任意PDF即可看到「翻译全文」选项

预期结果：插件会自动出现在右键菜单，首次使用需授权翻译API（应用程序接口）访问权限

快速上手：3步完成基础配置

准备工作

确保你的电脑已安装：
✅ Zotero 7（Zotero 6用户需单独下载兼容版本）
✅ Node.js 16+（用于构建插件的运行环境）

步骤1：获取项目文件

💡 实用提示：无需记住复杂命令，复制粘贴即可
🔍 重点操作：打开终端执行
git clone https://gitcode.com/gh_mirrors/zo/zotero-addons

预期结果：当前目录会生成「zotero-addons」文件夹，内含所有源代码

步骤2：安装依赖包

💡 实用提示：依赖安装失败通常是网络问题，建议切换稳定网络
🔍 重点操作：终端中继续执行
cd zotero-addons && npm install

预期结果：命令行会显示「added XX packages」，生成node_modules文件夹

步骤3：构建并安装插件

💡 实用提示：构建过程可能需要2-3分钟，请耐心等待
🔍 重点操作：执行构建命令
npm run build
完成后在Zotero中点击「工具→插件→从文件安装」，选择dist目录下的.xpi文件

预期结果：Zotero会提示「插件已安装」，重启后工具栏出现新图标

图：插件安装完成后在工具栏显示的图标

深度配置：新手/进阶双路径

新手路径：使用默认配置

1️⃣ 点击插件图标打开市场界面
2️⃣ 浏览「推荐插件」列表（按下载量排序）
3️⃣ 点击插件卡片查看详情（含功能描述和用户评分）
4️⃣ 一键安装后在「已安装」标签页管理

进阶路径：自定义数据源

当需要使用机构内部插件库时：
1️⃣ 进入插件设置界面（齿轮图标）
2️⃣ 切换「数据源」为「Custom Source」
3️⃣ 输入自定义URL（如https://your-university.com/plugins.json）
4️⃣ 点击「刷新」按钮加载私有插件列表

预期结果：自定义源插件会显示「🔒」标记，与官方插件区分展示

常见问题：解决90%的使用障碍

Q：安装后看不到插件图标？

A：需满足两个条件：① Zotero 7.0.5+版本 ② 从官方构建渠道安装。可在「工具→附加组件」中检查插件状态，若显示「禁用」点击启用并重启。

Q：插件安装失败提示「不兼容」？

A：这是因为插件元数据中的minVersion字段与当前Zotero版本不匹配。可尝试：

1. 在插件详情页查看「兼容版本」信息（橙色标注区域）
2. 升级Zotero到最新版
3. 联系插件作者获取适配版本

Q：如何备份已安装的插件列表？

A：在插件市场「设置」中点击「导出配置」，会生成JSON文件。重装系统后可通过「导入配置」一键恢复所有插件。

总结：从安装到精通的3个关键节点

1️⃣ 首次使用：完成3步基础配置后，优先安装「Zotero Connector」和「Better BibTeX」这两个必备插件
2️⃣ 日常管理：每周查看「更新」标签页，橙色提示的插件建议及时升级
3️⃣ 高级应用：学术团队管理员可参考项目doc目录下的「私有源搭建指南」部署内部插件库

现在，你已经掌握了这款工具的全部核心功能。告别复杂配置，让插件管理回归简单本质，把更多时间留给真正重要的学术研究吧！