Zotero SciHub插件终极使用指南：一键获取学术文献PDF

作为专为Zotero和Juris-M设计的智能插件，Zotero SciHub能够自动从Sci-Hub下载带有DOI的学术文献PDF文件，极大简化了科研工作者的文献管理流程。本指南将带你从零开始掌握这款强大的工具，实现高效的文献收集与管理。

🚀 快速入门：插件安装与配置

下载插件文件

首先需要获取插件的最新版本。插件以.xpi格式提供，这是Firefox扩展的标准格式，完全兼容Zotero平台。

安装到Zotero

1. 打开Zotero软件，点击顶部菜单栏的"工具"选项
2. 选择"插件"进入扩展管理界面
3. 点击右上角的齿轮图标，选择"从文件安装插件"
4. 浏览并选择你下载的.xpi文件
5. 重启Zotero完成安装过程

安装成功后，你将在扩展列表中看到Sci-Hub插件已成功添加。整个过程简单直观，即使是初次使用的用户也能轻松完成。

基础功能体验

安装完成后，你会发现右键点击文献库中的任何条目时，会出现一个新的上下文菜单选项"Update Scihub PDF"。点击这个选项，插件就会自动从Sci-Hub下载该文献的PDF文件并附加到对应的文献条目中。

⚙️ 个性化设置：打造专属文献获取方案

配置界面详解

插件提供了专门的配置界面，用户可以根据个人需求进行个性化设置：

主要配置选项包括：

• Sci-Hub服务器地址：自定义服务器地址以获得更好的访问体验
• 自动下载功能：开启或关闭新添加文献的自动PDF下载
• 网络连接参数：调整超时时间和重试次数

DNS-over-HTTPS配置

在某些网络环境下，配置DNS-over-HTTPS可以确保插件的稳定运行：

1. 进入Zotero的"偏好设置" > "高级" > "配置编辑器"
2. 设置network.trr.mode为2或3启用DNS-over-HTTPS
3. 设置network.trr.uri为https://cloudflare-dns.com/dns-query
4. 设置network.trr.bootstrapAddress为1.1.1.1
5. 重启Zotero使设置生效

🔧 故障排除：常见问题解决方案

插件安装失败处理

如果遇到安装问题，请检查以下几点：

• 确认下载的是最新版本的插件文件
• 验证Zotero版本与插件的兼容性
• 确保系统权限允许安装扩展程序

PDF下载失败排查

当PDF下载失败时，可能的原因包括：

• 文献条目缺少有效的DOI信息
• Sci-Hub服务器暂时不可访问
• 网络连接配置需要调整

建议检查文献的DOI字段是否填写正确，或尝试手动添加DOI信息后重试下载。

文件关联问题修复

如果下载的PDF文件没有正确关联到文献条目：

• 确认文献条目中已正确填写DOI信息
• 尝试手动重新关联附件文件
• 检查Zotero的"自动附加附件"设置是否启用

💡 高级技巧：提升使用效率的实用建议

批量处理文献

对于大量文献的PDF获取，建议分批处理以避免网络拥堵。插件支持同时处理多个文献条目，大大提升了工作效率。

自动化工作流

开启自动下载功能后，新添加的文献条目会自动触发PDF下载流程，无需手动操作。这一功能特别适合需要大量收集文献的研究人员。

🛠️ 开发者指南：从源码到构建

开发环境搭建

对于希望深入了解或参与项目开发的用户：

1. 安装Node.js开发环境
2. 运行npm install安装项目依赖
3. 使用npm run build构建项目文件
4. 通过npm run test运行测试用例

核心功能代码位于content/scihub.ts文件中，实现了主要的文献处理逻辑和PDF下载机制。

自定义功能扩展

开发者可以参考CONTRIBUTING.md文档，了解如何为插件添加新功能或优化现有功能。

📋 使用注意事项

使用本插件时，请务必注意以下事项：

• 遵守当地法律法规和学术道德规范
• 尊重知识产权相关法规
• 合理使用学术资源，避免滥用

插件仅提供技术便利，用户需自行承担使用责任。建议在合法和道德的范围内使用该工具进行学术研究，充分发挥其在科研工作中的价值。

通过本指南的详细介绍，相信你已经对Zotero SciHub插件有了全面的了解。这款强大的工具将显著提升你的文献管理效率，让学术研究更加轻松高效。