| name | search-reactions |
| description | 检索和比较结构化化学反应先例，保留来源、质量状态、条件和相似度定义。用于按反应 ID、组分、SMARTS 或整体反应相似性查找先例。 |
化学反应先例检索
能力
在明确 provider 和检索定义的前提下查找反应先例：
- 按 reaction ID 精确查找记录；
- 按输入/产物组分执行 exact、substructure、SMARTS 或 similarity 检索；
- 按 reaction SMARTS 查找转化模式；
- 用两套固定 RDKit reaction fingerprint 比较完整反应；
- 展示来源报告的参与物、条件、产率、许可和质量标记；
- 区分 zero hits、请求阻断、远程超时和远程错误；
- 保留 rejected/review 状态，不静默扩大查询或混排不可比分数。
适用于：
- “查找和这个反应相似的反应先例”；
- “ORD 里有没有这个 reaction ID”；
- “查产物含某个子结构的反应”；
- “按 reaction SMARTS 查相同转化”；
- “对比候选先例报告的条件和产率”。
执行流程
- 确认输入是结构化单步反应，不从论文正文或图片抽取反应。
- 显式确认
provider、operation、top_k、手性和 review 记录策略。
- 相似反应检索还必须确认
fingerprint_profile_id，不得使用隐藏默认值。
- 本地检索先独立验证 curate v1.1 Artifact 的 envelope、fingerprint、
record state、binding、canonical 和全局 ID，再执行 eligibility 和 search；
远程 ORD 只允许官方固定域名。
- 运行：
python scripts/search_reactions.py \
--input search-request.json \
--output reaction-precedents.json
- 校验：
python scripts/validate_output.py reaction-precedents.json
- 报告 provider 状态、query interpretation、命中数、排除记录、review queue、来源和许可。
首版 Provider
local_curated_corpus
消费 curate-reactions artifact；最多 50,000 条；离线确定性检索
ord_public_api
调用 https://open-reaction-database.org/api；最多召回 1,000 条候选
ORD 候选的结构相似度由本地固定 RDKit profile 重算。DataPro 或网页搜索只可
补论文元数据，不得参与结构召回或相似度。
强制边界
- 固定
rdkit==2025.9.2、ord-schema==0.8.3；
- operation 仅限
lookup_reaction、search_components、
search_transformations、search_similar_reactions；
- 本地 rejected 记录永不排序，review 记录只按显式选项纳入；
- 多个 component predicate 按 AND，不自动放宽；
- 不同 fingerprint profile、component similarity 与 whole-reaction
similarity 不可混排；
- 不设置默认 similarity threshold；
- score tie 按 provider、dataset ID、reaction ID 稳定排序；
- 条件和产率仅为来源报告证据，不进入相似度分数；
- 0 hit 只表示当前 provider/query 无命中，不能写成不存在先例；
- 不输出反应可行、条件最优、可安全执行或推荐条件；
- 不做 PDF 抽取、条件推荐、收率预测、产物预测、逆合成或路线批准；
- 不接受任意远程 URL、API Key、Cookie 或 Authorization。
与其他 Skill 的关系
curate-reactions
结构化反应、质量状态和可检索语料
↓
search-reactions
候选召回、显式排序和条件证据表
↓
review-routes
后续逐步先例覆盖和路线人工评审
完整输入输出字段、profile、状态和科学边界见
references/输入输出与科学边界.md 和
references/CurateArtifact消费合同.md。
