AbleSciDownloader

科研通下载器（AbleSciDownloader）

科研通下载器是第三方个人开源工具，免费开源（GNU AGPL-3.0），仅供学习交流使用。它并非科研通（ablesci.com）官方程序，与科研通及其运营方无任何隶属、合作或授权关系。如果你是付费购买的，你被骗了。

获取文献时，软件先查询合法的免费开放获取（OA）来源（OpenAlex、Europe PMC、PubMed Central、Unpaywall、arXiv、bioRxiv/medRxiv 等），能直接下载的直接下载；查不到时，才使用你本人的科研通账户在科研通发布求助，并通过科研通提供的下载渠道获取应助文件，积分消耗由你自行承担。不使用 Sci-Hub 等影子图书馆。请遵守著作权法、出版商许可、所在机构规定和科研通规则。完整声明见 DISCLAIMER.md。

推荐使用科研通，欢迎支持：捐助积分 · 无偿捐助

功能

• 导入：粘贴 DOI、参考文献、标题，或导入 CSV / DOC / DOCX / TXT / RIS / BibTeX / NBIB。优先提供 DOI，识别率最高。
• 文献检索（MCP / CLI）：关键词搜索 OpenAlex，支持年份、开放获取筛选和游标分页；结果由调用方筛选后再导入，不自动下载或发布求助。可在设置中加密保存免费 API Key，或通过服务进程环境变量 OPENALEX_API_KEY 使用个人额度；匿名额度受限且游标翻页需要密钥。
• 免费全文优先：先在合法 OA 来源查找并下载；出版社出现人机验证时交给你处理，不绕过。可选填写联系邮箱（用于 Unpaywall 等接口，默认不填）。
• 确认清单：找不到免费全文的文献整理成表格，由你确认后才会向科研通求助；悬赏只能选择官方档位。
• 科研通求助流程（需登录本人账户）：按 DOI 查询并二次核对后发布求助；积分低于 500 时遵守“逐条求助、收到应助须先处理”的规则；后台监控应助（刚发布时每 30 秒查看一次），收到应助后通知。
• 下载：三条普通线路测速选最快的一条；高速通道可设为 关闭 / 智能 / 强制，确认费用规则后才使用（同一文件只扣一次分）；失败自动重试（1、3、5、10 分钟，之后每 10 分钟），达到上限转为人工处理；单篇失败不影响其他文献。独立下载线程，下载期间不影响同步与发布。
• 核对：在本机核对 PDF 的 DOI、标题、作者和摘要；不一致时交给你判断。自动驳回仅限“文件与求助明显不符”，扫描件、预印本、格式问题一律由人工判断。
• 期限提示：显示科研通文件的删除时间与自动采纳时间（约 24 小时）。
• AI 辅助（可选，默认关闭）：DeepSeek Flash 预设或自定义 OpenAI 兼容接口，密钥用 Windows DPAPI 加密保存。不开启 AI 时，所有核心功能照常可用。
• 外部调用：提供 MCP 服务与命令行（kytdl.cmd），可被 Claude Code、Codex 等工具调用；调用方自带模型时无需配置 AI 密钥。详见 MCP_CONNECTION.md。
• MCP 后台求助规则：用户确认指定文献和悬赏后，AI 调用的常规求助、跟踪及下载在后台运行；严格核对一致的本人应助可自动采纳。不能自动判断或网站要求人工处理时才交给用户。免费来源失败或积分门槛阻塞不等于求助失败；没有可核实的到期结果时继续标记待处理。
• 日志与反馈：生成脱敏错误报告，可提交到 GitHub Issue。

安装与运行（Windows）

推荐免安装版（Windows 10/11 x64）： 在 Releases 下载 windows-x64.zip，完整解压后双击 启动科研通下载器.cmd。包内已有 Python 和依赖；首次自动从官方获取约 200 MB 浏览器到本目录，完成后自动打开。无需另装环境、输入命令或管理员权限；首次准备和文献操作需要联网。详见 免安装说明。

开发者使用源码版时，需要 Python 3.12/3.13 和 Google Chrome：

1. 下载或克隆本仓库到任意文件夹。
2. 双击 setup.cmd，创建虚拟环境并安装锁定版本的依赖。
3. 双击 启动科研通下载器.cmd 打开程序窗口。服务只监听本机 127.0.0.1:8769。

可在设置中开启开机自启与托盘常驻，关闭窗口后后台监控继续运行。

数据与隐私

• 所有数据保存在项目目录下的 data/（账户会话、下载的文件、记录、日志），请勿公开分享该文件夹。
• 科研通密码与 AI 密钥仅在你选择保存时，以 Windows DPAPI 加密存放，绑定当前 Windows 用户；不进入日志、报告或 MCP。
• 免费全文查询会向 OA 服务发送 DOI；开启 AI 后，仅在你逐次同意时发送选定的页面图片或文字片段。

已知限制

• 停止或重启后，自动流程和 MCP 后台续办均暂停，确认记录保留。通过 MCP 的 continue_authorized_request 可主动恢复指定的已确认文献；重新开启 MCP 权限不会自动恢复已暂停任务。

备注：因作者财力有限，积分 ≥ 500 的批量求助接口（科研通 /assist/create-batch 批量页面）以及对应的连续提交流程未经真实测试。 程序目前在 ≥ 500 积分时仍通过单篇求助页面连续提交。由于悬赏在发布时扣除，连续提交过程中积分可能跌破 500，此后科研通会改按“逐条求助”规则拒绝后续提交。程序已加入防护：每次发布前按“当前积分 − 本次悬赏”判断，预计跌破 500 时自动改为逐条求助规则，并在科研通提示需先处理应助时暂停发布、等待你处理。该防护同样未经真实环境验证，欢迎有条件的用户反馈。

• 不支持断点续传：科研通下载页按整文件下载，换线路或重试都从头开始。
• 下载速度取决于科研通文件节点与时段，程序只能在三条线路中选择最快的一条。
• 免安装 ZIP 仅提供 Windows x64；完整解压后使用。源码 ZIP 不含运行环境，需按源码安装步骤配置。

开发

测试：.venv\Scripts\python.exe -m unittest discover -s tests

设计文档位于 docs/。第三方组件见 THIRD_PARTY_NOTICES.md。

许可证

GNU AGPL-3.0