用途：通过 paperpile CLI 管理 Paperpile 文献库，并把引文解析为可下载的 PDF。所有库操作走命令行（纯 HTTP），不通过浏览器自动化操作 Paperpile 网页版。
主要能力：
- 库管理：paperpile auth 验证授权，paperpile index --refresh 刷新索引，paperpile search "关键词" 搜索，paperpile download <item_id> 按条目下载 PDF，paperpile fetch <bibkey> 按 bibkey 解析 PDF。
- 添加：paperpile add 可自动识别 DOI、网页 URL、远程 PDF URL 与本地 PDF，并支持 --title、--author、--year、--pubtype 等元数据；--force 仅在 DOI 无法取得 Guru 元数据时使用。
- 标签与编辑：paperpile label list/create/apply/remove/delete 管理标签；paperpile edit 修改标题、作者、年份、期刊、卷期页、摘要、URL、DOI 等字段，默认 dry-run，需加 --confirm 生效。
- find-and-add：paperpile find-and-add "<引文>" 解析作者、标题、期刊、卷页年、DOI、SSRN ID，经 Guru、CrossRef、OpenAlex 查元数据、去重、添加，并自动尝试获取 PDF；支持 --doi、--ssrn、--title、--author、--year、--journal、--volume、--page、--json、--no-pdf。
- 工具脚本：poll_attachment.sh 轮询附件，warmup.sh 预热代理会话，refresh-auth.sh 刷新授权，resolve_pdf.py 解析 DOI 或 bibkey 到 PDF（--via-browser 开启 CDP，--skip-paperpile 跳过库内副本直取出版版本）。
必要用法与前置：paperpile 二进制位于 ~/.local/bin/paperpile；需有效授权 cookie，失效时用 scripts/refresh-auth.sh 从已登录浏览器经 CDP 拉取并导入，默认端口 9222。PDF 解析需要可用的 CDP 浏览器，端口按 --cdp-port、$PAPERPILE_CDP_PORT、9250、9222 顺序取首个可达者；可用 --via-browser 开启浏览器驱动。若 /fetch-paper 技能可用，优先用其经 WRDS SOCKS 隧道获取付费 PDF，再 paperpile attach 附加到已有条目，避免新建重复条目。
限制与注意：add 本地 PDF 时由服务端文本提取器填充元数据，常丢失合著者、年份或重复标题，建议优先按 DOI 添加。trash 与 label delete 默认 dry-run，需 --confirm 才执行，且删除不可撤销；--force 添加 DOI 存根会污染库，需用户确认。search 依赖本地索引缓存，检索前先运行 paperpile index --refresh。不要用浏览器自动化操作 Paperpile 网页版，也不要直接用 curl 抓 DOI 链接。cookie 约 30 天过期，Shibboleth 约 8-12 小时硬过期。相关路径：cookies 在 ~/.claude-work/skills/paperpile/cookies/，缓存在 ~/.claude-work/skills/paperpile/cache/paperpile-index.json。其他未在资料中说明的细节暂未提供。