Paper Research

Paper Research — 学术文献搜索工具

通过命令行并行搜索多个学术数据库，自动去重合并，下载 PDF，导出 BibTeX。

Prerequisites

1. CLI binary available (install to ~/.local/bin/ or any directory in $PATH):

   scholar-cli --help
   

2. For WebBridge sources (Google Scholar, CNKI, WoS), kimi-webbridge daemon must be running:

   ~/.kimi-webbridge/bin/kimi-webbridge status
   

   If not running: invoke the kimi-webbridge skill.

命令速查

# 英文多源并行搜索（默认 7 个源）
scholar-cli search-en --query "关键词" --limit 10

# 指定源搜索
scholar-cli search-en --query "关键词" --sources openalex,semantic,arxiv,dblp

# Google Scholar（需要 WebBridge + 浏览器）
scholar-cli search-google --query "关键词" --limit 10

# 知网搜索（需要 WebBridge + 知网登录）
scholar-cli search-cnki --query "关键词" --limit 20

# Web of Science（需要 WebBridge + 机构登录）
scholar-cli search-wos --query "关键词" --limit 10

# 按 DOI 查论文详情
scholar-cli detail --doi "10.1145/3442188.3445922"

# 搜索并保存到工作区（自动去重）
scholar-cli search-en --query "关键词" --workspace /path/to/workspace

# 导出 BibTeX
scholar-cli export --workspace /path/to/workspace --output refs.bib

# 检查 WoS 登录状态
scholar-cli login-status --platform wos

所有可用源

search-en 默认并行搜索前 7 个 HTTP API 源。Google Scholar、CNKI、WoS 需要单独命令调用。

领域 → 源映射

不同学科的核心文献分布差异很大，选对源直接决定搜索质量。

使用策略

1. 已知领域 → 用 --sources 指定 2-3 个核心源，减少噪音

   # AI / CS 论文
   scholar-cli search-en --query "large language model reasoning" --sources arxiv,semantic,dblp --limit 15
   
   # 生物医学论文
   scholar-cli search-en --query "CRISPR gene therapy" --sources pubmed,biorxiv,crossref --limit 15
   
   # 工程/材料
   scholar-cli search-en --query "perovskite solar cell" --sources crossref,openalex --limit 15
   

2. 不确定领域 → 先用全源搜一轮，看 sources 汇总判断哪些源有料

   scholar-cli search-en --query "quantum computing" --limit 5
   # 看返回的 sources 字段，哪个 count 高就追加搜哪个
   

3. 中文研究 → 用 search-cnki，确保浏览器已登录知网

   scholar-cli search-cnki --query "大语言模型教育应用" --limit 20
   

4. 引用分析/高影响力筛选 → 用 WoS，需要机构 VPN/登录

   scholar-cli search-wos --query "transformer attention" --limit 20
   

5. 需要 Google Scholar → 被 CAPTCHA 拦截时，让用户在浏览器里手动过验证码，之后短时间内可用

   scholar-cli search-google --query "attention mechanism survey"
   

搜索关键词技巧

• 英文源：用英文关键词，支持布尔逻辑（取决于各源 API）
• 知网：用中文关键词，和知网网页搜索行为一致
• DBLP：对 CS 会议/期刊论文标题匹配特别准，适合精确查找
• bioRxiv：通过 CrossRef DOI 前缀过滤实现，搜索质量与 CrossRef 一致
• DOI 查详情：如果从搜索结果里拿到了 DOI，用 detail 命令补全完整信息（作者机构、摘要、引用数、PDF 链接）

工作区管理

工作区用于跨多次搜索累积论文，自动按 DOI / 标题+作者 去重：

# 多次搜索存同一个工作区
scholar-cli search-en --query "term1" --workspace ~/research/my-survey --limit 10
scholar-cli search-en --query "term2" --workspace ~/research/my-survey --limit 10

# 最后统一导出 BibTeX
scholar-cli export --workspace ~/research/my-survey --output ~/research/my-survey/refs.bib

返回值中 papers_added 表示新增了多少篇（已有的不重复添加），total_stored 是工作区总数。

输出格式

所有命令输出 JSON：

• 成功：{"ok": true, "data": {...}}
• 失败：{"ok": false, "error": {"code": "...", "message": "..."}}

论文字段：title, authors, abstract, year, doi, venue, volume, issue, pages, citations, references, open_access, pdf_url, source, sources, urls, identifiers

常见问题

知网（CNKI）使用说明

使用 search-cnki 前，必须在浏览器中完成以下准备：

1. 登录知网 — 在 Chrome 中打开 https://www.cnki.net 并登录账号
2. 过一次滑块验证码 — 打开 https://kns.cnki.net 搜索任意关键词，如果弹出滑块验证码（"安全验证"页面），手动拖动滑块完成验证

知网的滑块验证码（blockPuzzle 类型）不仅在登录时出现，以下场景也会触发：

• 新会话 / 新 IP 首次访问
• 短时间内搜索次数过多
• 检测到自动化浏览器行为

验证码无法自动破解，必须手动完成。过一次之后同一浏览器会话可保持一段时间正常使用。

如果 search-cnki 返回错误或空结果，优先让用户在浏览器里访问 kns.cnki.net 确认是否需要重新过验证码。

依赖

• 7 个 HTTP API 源（OpenAlex, Semantic Scholar, CrossRef, arXiv, PubMed, DBLP, bioRxiv）：无需登录，直接 HTTP 调用
• Google Scholar：需要 kimi-webbridge 运行 + Chrome 打开
• CNKI 知网：需要 kimi-webbridge 运行 + Chrome 打开 + 知网已登录 + 手动过一次滑块验证码
• Web of Science：需要 kimi-webbridge 运行 + Chrome 打开 + 机构 SSO 登录