菜单
批量下载文献 PDF（DOI/PMID/标题/阅读清单都行）。先走开放获取(Unpaywall/Europe PMC)，付费再走 Sci-Hub，校验真伪、写 manifest；拿不到的转 VPN 清单。@ 触发:"@下载文献""@download-papers""@下论文""@抓文献"。自然语言:"下载文献""下载论文""把这些文献下了""批量下 PDF""download papers""从综述里把参考文献下了"。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | paper-download |
| description | 批量下载文献 PDF（DOI/PMID/标题/阅读清单都行）。先走开放获取(Unpaywall/Europe PMC)，付费再走 Sci-Hub，校验真伪、写 manifest；拿不到的转 VPN 清单。@ 触发:"@下载文献""@download-papers""@下论文""@抓文献"。自然语言:"下载文献""下载论文""把这些文献下了""批量下 PDF""download papers""从综述里把参考文献下了"。 |
风格：简洁、表格、数据先行、不用装饰词。逐步执行，每步报告，最后给总览。
核心只需 python3（纯标准库）+ curl，不需要 pip 装任何包。
bash "$SKILL_DIR/scripts/setup_check.sh"
缺 python3/curl 时脚本会给出对应平台的安装命令（macOS brew / Debian apt / Fedora dnf）。pdftotext 可选（只用来核验标题）。
脚本吃三种输入（自动识别）：
.json：[{"title":..,"doi":..,"pmid":..,"pmcid":..,"authors":..,"year":..}, ...]（字段都可选）.txt/.md：每行一个 DOI / PMID / PMCID / 或标题（# 开头忽略）-：从 stdin 读若用户给的是综述/map 文件 → 先把要下的文献抽成上面任一格式（标题或 DOI 一行一个即可）。总数大时先确认范围（如"只下核心 ≤30 篇"）。
python3 "$SKILL_DIR/scripts/download_papers.py" INPUT --out "目标文件夹" --email 用户邮箱 --workers 3
--out：PDF 落地目录（默认当前目录）。--workers：保持 3 或更低——Sci-Hub 的 ddos-guard 并发高会限流（实测）。产出：PDF + manifest.md（✅已下 / ❌仅链接两张表）+ _results.json（机读，给下一步用）。
| 步 | 手段 | 说明 |
|---|---|---|
| 解析 DOI | 给定 DOI → NCBI idconv(PMID) → Crossref 题名检索 | 错 DOI 会抓错文，题名检索有 0.45 阈值兜底 |
| 开放获取 | Europe PMC render → Unpaywall | OA 首选，最稳；PMC 直连已反爬，别用 |
| 付费回退 | Sci-Hub（cookie 预热 + 多镜像 + 重试 + /storage/ 正则） | 仅对 ≤2021 老论文有效 |
| 校验 | %PDF- 头 + 体积 >30KB + 正文标题词匹配(pdftotext) | Sci-Hub 会串文(返回完全不相干的 PDF)，必须验正文，否则会把错文当成功 |
细节、API 列表、各网站反爬排坑见 references/sources.md（遇到下不动/限流先读它）。
%PDF+体积 检不出"串文"。下完跑审计，揪出错文/重复/无文字层：
python3 "$SKILL_DIR/scripts/verify_pdfs.py" "目标文件夹" # 只报告
python3 "$SKILL_DIR/scripts/verify_pdfs.py" "目标文件夹" --delete-dups # 顺手删重复
--delete-dups 清掉。报告：成功 N / 失败 M。失败的（付费墙、Sci-Hub 没有，多是 2022+ 新刊）→ 调用 paper-vpn-list 技能，把 _results.json 一键整理成 VPN/图书馆直链清单交给用户（用户有校园 VPN 时这是最可靠的补全方式）。