Zotero-SciHub 插件完整使用指南

Zotero-SciHub 是一个专为 Zotero 和 Juris-M 设计的插件，能够自动从 Sci-Hub 下载带有 DOI 的文献 PDF 文件。本指南将详细介绍插件的安装、使用方法和常见问题解决方案。

插件安装步骤

下载插件文件

首先需要获取插件的最新版本文件。插件以 .xpi 格式提供，这是 Firefox 扩展的标准格式。

安装到 Zotero

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

安装完成后，在扩展列表中可以看到 Sci-Hub 插件已成功添加。

基本使用方法

手动下载 PDF

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

自动下载功能

对于新添加的文献条目，插件会自动检测并下载对应的 PDF 文件，无需手动操作。这一功能大大简化了文献管理的流程。

配置选项

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

主要配置选项包括：

• Sci-Hub 服务器地址设置
• 自动下载功能开关
• 网络连接参数调整

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 使设置生效

常见问题解决

插件安装失败

如果无法找到 .xpi 文件或安装失败，请确保：

• 下载的是最新版本的插件文件
• Zotero 版本与插件兼容
• 系统权限允许安装扩展

PDF 下载失败

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

• 文献缺少 DOI 信息
• Sci-Hub 服务器暂时不可用
• 网络连接问题

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

PDF 关联错误

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

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

技术实现原理

Zotero-SciHub 插件基于 TypeScript 开发，主要通过以下方式工作：

1. DOI 提取：从文献条目的多个字段中提取 DOI 信息
2. URL 生成：根据配置的 Sci-Hub 服务器地址生成访问链接
3. PDF 下载：通过 HTTP 请求获取 PDF 文件内容
4. 附件关联：将下载的 PDF 文件关联到对应的文献条目

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

开发者信息

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

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

详细的开发指南请参考 CONTRIBUTING.md 文件。

注意事项

使用本插件时请注意：

• 遵守当地法律法规
• 尊重知识产权相关法规
• 合理使用学术资源

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