用途:用于多数据库文献检索与检索策略设计,输出结构化、可复现的结果列表;适用于参考文献检索、系统检索、综述选题,以及在可复现流程中构建可追溯的检索策略。当需要打包方法而非临时自由输出、或需要脚本 scripts/pubmed_search.py 直接完成请求时使用。
主要能力:多数据库检索框架(目前仅实现 PubMed);自动关键词提取与检索策略构建(布尔逻辑加字段限制);结构化输出,包括机器可读 JSON 与便于表格处理的 CSV;可复现检索记录(检索式、关键词、结果数量与记录列表);网络访问限制在官方 PubMed E-utilities 端点。
使用方式:环境依赖 Python 3.10+,仅用标准库。示例命令:cd "20260316/scientific-skills/Evidence Insight/reference-search";python -m py_compile scripts/pubmed_search.py;python scripts/pubmed_search.py --help。运行前需确认输入、输出路径与必要配置;编辑 scripts/pubmed_search.py 中的 CONFIG 块,其中 EMAIL 必填(须由用户提供,不得硬编码真实凭据),API_KEY 可选(可提升速率限制),RETMAX 为最大返回记录数,OUTPUT_DIR 必须指向 outputs 子目录。
限制与约束:网络仅允许访问 eutils.ncbi.nlm.nih.gov;禁止第三方 URL;不得读取技能目录外文件;输出仅写入 outputs/;每个 API 请求超时 20 秒,请求间隔限速 0.35 秒;错误返回语义化用户提示,不暴露敏感技术细节。第三方包未在本技能中固定版本。多来源合并去重需在外部完成并保留来源标签。输出需保持可复现、显式标注假设,避免未记录的副作用。