sn-search-academic

用途：面向学术调研，提供搜索论文与百科条目、精读论文全文或章节、梳理相关工作、追溯引用链（references 与 citations）等能力。主要能力由三个统一入口提供：scripts/search.py 搜索论文/百科（支持 arxiv、semantic、google_scholar、pubmed、ssrn、wikipedia，可按 source 分组返回）；scripts/paper.py 列出论文章节、读取全文或指定章节（arxiv 与 pmc 来源）；scripts/refTree.py 查询引用树。不要直接调用历史 provider 脚本，它们只是内部实现。用法：凭证（API key、token、cookie）统一写仓库根目录 .env，脚本只从环境变量或显式 CLI 参数读取，不要把真实密钥写入 payload、报告或日志。首次运行用 python3 -m pip install -r requirements.txt 安装依赖；Crawler 回退还需 python3 -m playwright install firefox，部分 crawler 脚本还需 Node.js 及已安装 camoufox-js 的 node_modules。三个脚本均输出 JSON，先看顶层 success，失败时读取 error、errors、attempts。search.py 结果在 source_results[].items；paper.py 正文在 content，--list_section 只返回章节结构；refTree.py 结果在 source_results[].references / citations，--paper_id 与 --title 均必填。约定：不要并发运行多个本技能脚本，一次只运行一个并等待返回；长结果用 --output <path> 写入文件；--provider-timeout 为单个 provider 超时，默认 60，0 表示不限。限制：依赖安装失败、网络不可用或包不可用时应停止对应脚本并改用 WebSearch/browser-use 并说明缺少依赖；缺少 crawler 运行环境时不要绕过，改用非 crawler provider 或网页搜索；paper.py 不确定章节名时先用 --list_section。分类速查可用于 --category，如 cs.AI、cs.LG、cs.CL、cs.CV、stat.ML、q-bio.NC 等。具体字段与回退链见 references/search.md、references/paper.md、references/refTree.md。