Write a literature review based on papers in a workspace. Covers topic organization, narrative structure, gap identification, and BibTeX export. Use when the user wants to draft a literature review, survey a research area, or summarize the state of the art.
基于工作区中的论文,撰写结构化的文献综述。
用户必须指定一个 workspace(--ws NAME)。如果用户未指定:
scholaraio ws list 列出已有工作区综述输出写入 workspace/<name>/ 目录。
向用户确认:
scholaraio ws show <name> # 查看工作区论文列表
scholaraio ws search <name> "<主题>" # 范围内搜索
scholaraio topics # 主题聚类概览(如已建模)
对工作区内论文做 L1-L2 快速扫描(标题 + 摘要),建立全局认知:
scholaraio show <dir_name> --layer 2 # 逐篇扫描摘要
根据文献内容,提出分组方案(按方法/时间线/研究问题/理论流派),形成章节大纲。向用户展示大纲并确认。
常见组织方式:
对每个章节的核心论文,先检查是否有历史分析笔记(data/papers/<dir>/notes.md),有则复用已有发现,避免重复劳动。
然后加载 L3(结论)或 L4(全文):
scholaraio show <dir_name> --layer 3 # 结论
scholaraio show <dir_name> --layer 4 # 全文(仅关键论文)
分析完成后,将值得跨会话保留的关键发现追加到论文的 notes.md(通过 loader.append_notes())。格式:## YYYY-MM-DD | <workspace> | literature-review,内容包括方法特点、核心贡献、与其他论文的关键对比。
多模态分析(MinerU 解析的论文保留了图表和公式):
data/papers/<dir>/images/),辅助理解实验结果和方法流程引用图谱辅助发现关联:
scholaraio shared-refs "<id1>" "<id2>" # 共同引用分析
scholaraio refs "<id>" # 参考文献
scholaraio citing "<id>" # 被引论文
按确认的大纲逐节撰写。写作原则:
(Author, Year) 或 Author (Year),与 BibTeX key 对应每写完一节,暂停让用户审阅,再继续下一节。
scholaraio ws export <name> -o workspace/<name>/references.bib
workspace/<name>/literature-review.md(或用户指定的文件名)用户说:"帮我写一篇关于湍流减阻的文献综述,基于 drag-review 工作区"
→ 查看 ws show drag-review,扫描论文,提出大纲,逐节撰写
用户说:"我有一段范文,帮我按这个风格写" → 分析范文的结构和叙述特征,然后仿照该风格组织语言