Literature Review

核心功能

Literature Review 是一款专为学术研究者设计的文献综述辅助工具，通过整合两大主流学术数据库 API——Semantic Scholar（S2）与 OpenAlex（OA），提供从文献检索、元数据提取到内容综合的全流程支持。

核心用法

1. 多源检索策略：默认使用 OpenAlex 进行快速广泛的初步探索（Topic Exploration），利用其响应速度快、覆盖全面的特点；针对特定研究问题切换至 Semantic Scholar 获取深度信息，包括 TL;DR 摘要、高质量引用元数据及论文详情。

2. 双源交叉验证：支持同时调用两个数据源（--source both），确保文献查全率，避免单一数据库的收录盲区。

3. DOI 精准定位：通过 DOI 直接获取单篇论文完整信息，支持参考文献的精确核实。

4. 智能内容合成：提取摘要关键发现后，按主题或时间逻辑组织，采用"分步思考"（Think step-by-step）方法将多源信息整合为连贯的学术叙事。

显著优势

• API 整合优势：直接对接权威学术数据库，获取实时、结构化的学术元数据
• 格式兼容性：自动处理 OpenAlex 的倒排索引摘要格式，重建可读文本
• 礼貌池访问：自动识别邮箱以使用 OpenAlex 高速通道（Polite Pool）
• 引用质量把控：提供 citationCount 指标与 externalIds（DOI/PubMed）交叉验证，辅助筛选高影响力文献

局限性与注意事项

• 全文获取限制：仅支持元数据与摘要层级，无法直接获取 PDF 全文
• API 依赖性：受限于 Semantic Scholar 和 OpenAlex 的服务稳定性与速率限制
• 领域覆盖差异：部分新兴或小众领域文献收录可能不完整
• 合成质量边界：内容综合依赖用户后续人工判断，工具仅提供结构化素材

适合人群

• 硕博研究生、博士后及青年学者
• 需要快速掌握陌生研究领域的交叉学科研究者
• 科研团队文献调研与年度综述撰写人员

常规风险

• 引用信息需人工复核 externalIds 确保准确性
• 高被引论文未必代表方法学最优，需结合研究目的综合评估
• API 密钥或邮箱配置不当可能导致访问受限

核心用法

literature-review 是一款专为学术研究者设计的文献检索与综述辅助工具，通过 Python 脚本整合 Semantic Scholar (S2) 和 OpenAlex (OA) 两大开放学术数据库 API，实现从主题探索到综述撰写的全流程支持。

检索模式灵活：

• OpenAlex 模式（默认）：响应快速、覆盖广泛，适合初期主题探索与大规模文献扫描
• Semantic Scholar 模式：提供 TL;DR 摘要、高质量引用元数据，适合深度分析重点论文
• 双源并行模式：同时检索两数据库，确保文献无遗漏

关键功能：支持 DOI 精确查询、摘要自动重建（处理 OpenAlex 倒排索引格式）、按主题分组与引用数筛选，输出包含标题、年份、作者、摘要、引用数等核心元数据。

显著优点

1. 数据源权威可靠：直接对接 Semantic Scholar（微软研究院）与 OpenAlex（OpenAlex.org）两大知名学术平台，数据覆盖全球数千万篇论文
2. 零成本学术访问：两 API 均提供免费层级，OpenAlex 更完全免费开放
3. 智能摘要处理：自动重建 OpenAlex 的倒排索引摘要，输出可读性强的完整文本
4. Polite Pool 机制：通过环境变量配置用户邮箱，获得 OpenAlex 更高优先级访问权限
5. 引用友好输出：保留 DOI、PubMed ID 等外部标识符，便于直接生成规范参考文献

潜在局限

1. 依赖网络连接：所有数据实时从 API 获取，离线不可用
2. API 速率限制：免费层级存在调用频次上限，大规模检索可能受限
3. 元数据非全文：仅获取标题、摘要等元数据，无法直接下载 PDF 全文
4. 默认邮箱需替换：CLAWDBOT_EMAIL 默认值为开发者邮箱，正式使用需用户自行配置
5. 无内置去重：双源并行检索时，同一论文可能重复出现，需手动或后续处理去重

适合人群

• 研究生与博士生：撰写开题报告、文献综述章节
• 科研人员：快速扫描领域新进展、追踪特定研究方向
• 学术写作辅助：需要规范引用格式与多源交叉验证的研究者
• 图书情报从业者：进行文献计量与学科态势分析

常规风险

• 搜索隐私：查询关键词可能被 API 提供方记录，敏感研究主题需注意
• 数据时效性：依赖外部数据库更新，最新预印本可能存在滞后
• 摘要准确性：自动重建的摘要偶有格式问题，关键论文建议人工核对原文
• API 服务稳定性：第三方服务可能出现临时中断，重要工作建议本地缓存结果