用途:根据用户提供的 DOI 下载论文 PDF 全文,支持单个、多个 DOI 列表及 WoS savedrecs.xls 批量导入。
主要能力:按出版商路由下载;对 10.1021、10.1039、10.1126、10.1109、10.1063、10.1088、10.1103、10.1146、10.1080 等无公共 TDM API 的 DOI 自动加 --use-browser-fallback;DOI 超过 100 条时自动加 --resume --batch-size 500;默认不覆盖已有文件;支持断点续传、分批处理、限速与 dry-run。
使用方式:先确保 auto_paper_download 可导入(在仓库根目录 pip install -e .,浏览器回退需加 [browser] extra 并 playwright install chromium),并在运行目录放置 .env,至少含 CROSSREF_MAILTO。运行前回显即将下载的 DOI 数量。命令示例:python .claude/skills/paper-download/scripts/download_by_doi.py --doi <DOI> [--use-browser-fallback] [--verbose];python .claude/skills/paper-download/scripts/download_multiple_dois.py --doi-file ./dois.txt [--resume] [--batch-size 500];python -m auto_paper_download --savedrecs ./savedrecs.xls。
输出:默认目录 ./downloads/pdfs/,按 DOI slug 建子目录存放主 PDF 与补充材料,浏览器回退结果在 _browser_fallback/,多 DOI 脚本生成 state/ 下的 checkpoint 与成功失败列表。CLI 会输出各出版商成功率及最多 20 条失败原因。
限制:首次使用浏览器回退需人工完成机构 SSO 登录;.env 凭据缺失会静默禁用该路径;出版商改版可能导致 no_link;Springer API 仅提供 OA,需回退;遇到 auth_redirect 需登录后重跑。