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

Zotero-SciHub是一款专为Zotero文献管理软件设计的强大插件，能够自动从Sci-Hub下载带有DOI的文献PDF文件，彻底解决了学术研究中文献获取的难题。无论你是科研新手还是资深学者，这款插件都能让你的文献管理效率翻倍！

🔍 插件核心功能详解

自动PDF下载功能

安装Zotero-SciHub插件后，系统会自动为新添加的文献条目下载对应的PDF文件。这一智能功能基于DOI识别技术，确保每篇文献都能快速获得完整版本。

手动更新选项

对于已有的文献条目，右键点击即可看到"Update Scihub PDF"选项，点击后插件会立即从Sci-Hub服务器下载最新PDF并自动关联到文献。

🚀 完整安装步骤

获取插件文件

首先需要下载插件的最新版本文件。可以通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/zo/zotero-scihub

安装到Zotero

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

安装成功后，在扩展列表中就能看到Sci-Hub插件已经就绪！

⚙️ 配置与个性化设置

插件提供了专门的配置界面，用户可以根据个人需求进行灵活调整：

主要配置选项包括：

• Sci-Hub服务器地址自定义
• 自动下载功能开关控制
• 网络连接参数优化

🌐 网络环境优化技巧

在某些网络环境下，可能需要配置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使设置生效

💡 实用技巧与问题解决

常见问题快速排查

PDF下载失败怎么办？

• 检查文献是否包含正确的DOI信息
• 确认Sci-Hub服务器当前可用性
• 验证网络连接状态

文献关联错误如何处理？

• 确保文献条目中DOI字段填写准确
• 手动重新关联PDF附件
• 检查Zotero的自动附件设置

最佳使用实践

• 定期检查插件更新，确保使用最新版本
• 合理配置自动下载功能，避免资源浪费
• 结合Zotero的其他插件，打造个性化文献管理流程

🔧 技术实现原理

Zotero-SciHub插件基于TypeScript开发，通过以下四个核心步骤实现功能：

1. DOI信息提取 - 从文献条目的多个字段中智能识别DOI
2. 访问链接生成 - 根据配置的Sci-Hub服务器地址构建完整URL
3. PDF文件下载 - 通过HTTP请求高效获取PDF内容
4. 附件自动关联 - 将下载的PDF文件精准关联到对应文献

核心功能代码位于content/scihub.ts文件中，实现了完整的文献处理逻辑。

📚 开发者信息

对于希望参与项目开发的用户，项目提供了完整的开发环境：

npm install    # 安装项目依赖
npm run build  # 构建插件文件
npm run test   # 运行测试用例

详细的开发指南请参考项目文档。

⚠️ 重要注意事项

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

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

这款插件仅为学术研究提供技术便利，用户需自行承担使用责任。建议在合法和道德的范围内使用该工具，共同维护良好的学术环境。

通过本指南，相信你已经掌握了Zotero-SciHub插件的核心使用方法。立即安装体验，让你的文献管理变得更加高效便捷！