release: v0.20 Codex-ready skill-driven core

docs/search-playbook.md

@@ -8,13 +8,14 @@ v0.12 起，默认搜索路径收敛到项目内 Python 网关：
 
 ```bash
 uv run python scripts/search.py "<query>" --route scholar --num-results 10 --year-low 2023
+uv run python scripts/search.py "<query>" --route evidence --num-results 10 --json --trace
 uv run python scripts/search.py "<query>" --route patents --num-results 10
 uv run python scripts/search.py "<query>" --route news --num-results 10 --time-range m
 uv run python scripts/search.py "<query>" --route general --num-results 10
 uv run python scripts/ground.py "<query>" --json
 ```
 
-其中 `scholar / patents / news` 默认走严格模式（Serper 失败不静默降级）；需要容错时显式加 `--no-strict-specialized`。
+其中 `scholar / patents / news` 默认走严格模式（Serper 失败不静默降级）；需要容错时显式加 `--no-strict-specialized`。`evidence` 是 v0.20.1 之后新增的受控证据发现路由，优先用 Exa highlights/text 为 evidence packet 提供候选来源。
 
 MCP server 只作为交互式补漏和特殊工具能力，不作为文献、专利、新闻检索主路径。这样 OpenCode、Codex、Gemini CLI、Claude Code 都能复用同一套路由，减少每个平台单独配置 Tavily/Exa/Brave MCP 的依赖。
 
@@ -23,13 +24,14 @@ MCP server 只作为交互式补漏和特殊工具能力，不作为文献、专
 ### Tavily
 
 - 优点：LLM 友好，摘要质量稳定，适合快速发现方向。
-- 用法：初扫、普通网页、报告线索、交叉补漏。
+- 用法：初扫、普通网页、报告线索、交叉补漏；`research()` 更适合 Phase 1 初步扫描、薄弱章节补证据、Phase 3 回炉。
 - 风险：不能把普通网页当结论支撑，必须追溯原始来源。
+- 规则：Tavily Research 输出必须保存为过程文件，并经过 source-quality 评分、去重和 source_id 归一化；不要直接把 Tavily 的综合报告当作章节正文或最终证据。
 
 ### Exa
 
-- 优点：neural search，对官网、公司页、长尾专业内容召回好。
-- 用法：术语核查、公司/产品名纠错、专业网页发现。
+- 优点：neural/agent search，对官网、公司页、长尾专业内容召回好；highlights/text 适合喂给 agent 做证据筛选。
+- 用法：`scripts/search.py --route evidence`、术语核查、公司/产品名纠错、专业网页发现、章节证据补强。
 - 风险：macOS 代理环境容易 TLS EOF，项目内 `SearchClient` 已使用 `trust_env=False` 绕开系统代理。
 
 ### Brave
@@ -71,13 +73,22 @@ MCP server 只作为交互式补漏和特殊工具能力，不作为文献、专
 
 ## Recommended Profiles
 
+## v0.20 Routing Decision
+
+- Phase 1 初步扫描：Tavily Research + Exa evidence，目标是形成假设、反证方向、章节任务切分。
+- Phase 2 evidence packet：优先 `fda/scholar/patents/news` 等专用路由；需要补充候选证据时用 `evidence`，不要只用 `general`。
+- Phase 3 回炉：按 critique 中的证据缺口定向调用 Tavily Research 或 Exa evidence，输出仍需进入 packet/schema。
+- General route：只做宽泛发现和兜底，不作为“默认最佳搜索”。
+
+## Recommended Profiles
+
 ### biomed_literature
 
-PubMed / NCBI → ClinicalTrials → FDA/EMA/NMPA → `scripts/search.py --route scholar` → Tavily/Exa 补漏。
+PubMed / NCBI → ClinicalTrials → FDA/EMA/NMPA → `scripts/search.py --route scholar` → `scripts/search.py --route evidence` → Tavily/Brave 补漏。
 
 ### patent_heavy
 
-`scripts/search.py --route patents` → USPTO/EPO/CNIPA → 公司年报/招股书 → Tavily/Exa 补同族专利线索。
+`scripts/search.py --route patents` → USPTO/EPO/CNIPA → 公司年报/招股书 → Exa/Tavily 补同族专利线索。
 
 ### china_market