用途:当用户明确要求做系统综述、文献综述、相关工作或文献调研时,用它在隔离工作目录内完成从多查询检索到 PDF/Word 交货的完整流水线;为研究想法核对强近邻与新颖性时可用 novelty-check 模式(只运行到选文阶段,输出强近邻、反方/边界证据与证据深度,不生成正文/PDF/Word)。不适用于只补单条参考文献、润色正文或写普通摘要。
主要能力与流程:阶段 1/2 依赖 research-literature-search(契约 rls.v1),只消费其 manifest、canonical candidates 与 provenance,不内嵌 provider、不重复去重;随后 AI 逐篇按评分提示输出 scored_papers.jsonl(1-10 分,仅 ≥5 分分配子主题),select_references.py 按相关性、证据角色与软预算选出集合并生成 selected_papers.jsonl、references.bib、selection_rationale.yaml;再规划 3-7 个子主题与配额、用 plan_word_budget.py 生成字数预算,按固定章节(摘要、引言、子主题段、讨论、展望、结论)写作;最后用 compile_latex_with_bibtex.py 与 convert_latex_to_word.py 导出 PDF/Word,可选 multi_language.py 生成多语言版本。
使用方式:先读 references/ai_query_generation_prompt.md 生成多查询 JSON(有效数量需满足 config.yaml 的 min/max),再运行 pipeline。示例: python3 scripts/run_pipeline.py --topic "{主题}" --query-file ./queries.json --publish-dir ./review-deliverables 两步式: python3 scripts/pipeline_runner.py --topic "{主题}" --work-dir <work-dir> --prepare-only python3 scripts/pipeline_runner.py --resume <work-dir> --resume-from 1 --publish-dir ./review-deliverables 单查询后备需显式加 --allow-single-query-fallback 并写 --fallback-reason。
运行环境与限制:需 Python 3.9+、LaTeX(xelatex/bibtex)、pandoc;正文字数与参考文献数须落在当前档位范围内,\cite{key} 必须与 BibTeX key 一致,多查询缺失/冲突时阶段 1 fail-closed;正式交付目录须用 --publish-dir 显式指定,PDF/Word 为强制导出(明确失败并记录原因才可缺失)。旧名 systematic-literature-review 仅为提示兼容别名。价格、收费与具体数据库清单等资料暂未提供。