用途:把编码代理变成文献研究助手,用于按主题、作者或会议检索论文,查看元数据、摘要、TL;DR 与参考文献,追踪引用某篇论文的后续工作,下载 arXiv PDF 并提取文本,或围绕某主题构建阅读清单。
主要能力:内置 Python CLI 脚本,支持多个子命令。search <query> [--limit N] 执行 Semantic Scholar 检索(最多 20 条);detail <paper_id> 返回完整元数据、TL;DR 与主要参考文献;citations <paper_id> [--limit N] 返回引用该论文的工作(最多 20 条);arxiv <query> [--max-results N] 检索 arXiv 预印本(最多 10 条);download <arxiv_id> [--save-dir D] 保存 PDF;read <pdf_path> [--max-pages N] 用 PyMuPDF 提取文本。detail 与 citations 会自动识别 ID 类型:以 10. 开头的 DOI、10 位以上纯数字视为 arXiv ID、长十六进制串视为 Semantic Scholar paperId。
使用方式:需先确认依赖,命令为 python -c "import httpx, arxiv, fitz" 2>&1 || python -m pip install httpx arxiv PyMuPDF;无 python 时可改用 py 或绝对解释器路径,并用同一解释器执行 pip。随后运行 python "${CLAUDE_PLUGIN_ROOT}/skills/papers-skill/scripts/papers.py" <subcommand> [args]。脚本已随技能打包,无需单独安装。建议先 detail 确认论文匹配,再 download;输出标题时附带论文 ID 以便再次查询;下载后报告绝对保存路径。
适用场景:文献综述扫描、单篇论文精读(问题·方法·关键结果·局限)、影响力分析、阅读清单整理。
限制:无法获取 Elsevier、Springer、Wiley 等付费全文,仅能读取开放 arXiv PDF;PyMuPDF 只提取嵌入文本,扫描版 PDF 返回“PDF无法提取文本(可能是扫描件)”,需另行 OCR;Semantic Scholar 匿名访问限流严格,脚本会以指数退避重试 3 次,持续 429 会报“搜索失败: rate limit, retries exhausted”。仅向 api.semanticscholar.org 与 arxiv.org 发起 HTTPS 请求,不发送认证令牌,也无需或存储任何凭据或 API 密钥。