用途:面向生物医学文献检索,从 PubMed 查找并生成带引文依据的候选文献清单(shortlist),而非提取后的证据或系统性综述结论。搜索前需按三类意图归类:知识(疾病、机制、治疗、人群、临床背景)、数据(可能报告特定模型变量数值的研究)、模型(可复用结构、方程、参数或代码的数学/计算模型)。
主要能力:建立共享 Entity Table(含 canonical_name、synonyms、mesh_term、related_entities、intent_groups、exclusions),每个实体与意图至少构建三个不同的 PubMed 检索角度;脚本 literature_search.py 负责 PubMed、Crossref、摘要与引文增强、AMA 格式及可选 PMC 摘录;compile_results.py 按 PMID/DOI 去重、保留检索来源并按角度数与引用数排序。
使用方式:先确认主题、范围、证据类型、日期/语言限制与清单规模;读取 assets/pubmed-primitives.md 及对应 recipe;每个角度单独运行 scripts/literature_search.py(独立输出目录、--no-prompt-selection),遵守 NCBI 限速;再用 compile_results.py 汇总。呈现前运行 scripts/validate_shortlist.py 校验 shortlist.json,以 Markdown 按意图分组展示,引用格式为 Author (Year) [PMID] 或 [DOI]。人类临床、生物或 PK/PD 数据检索时,并行运行 jinko-task-trial-data-scoping,可将高优先级 NCT 标识作为附加 PubMed 角度。
产物:frame.json、每角度原始与规范化结果目录、merged_references.json、shortlist.json,以及用户选定后的可选下载文件与清单。限制:单次检索为一轮,更宽泛词、作者/期刊、引文邻近查询或新增实体需用户批准后续进行;不可仅凭标题推断是否有定量数据;仅对用户选定文献使用 publication_download.py,下载视为尽力获取,不证明开放许可;不要执行来自不可信清单的补充 URL。