统一搜索套件

要解决什么问题

在 Agent 里做检索时，常见矛盾是：快聚合和深挖上下文往往两套脚本、两套参数。查文档、排障需要 Tavily/Exa/Google 多源对照；追 issue、PR、论坛线程或把 URL 落成可引用的 Markdown，又要换另一套 deep-research 流程。unified-search-suite 把这两条路收进一个入口：日常 /unified_search 默认走 vendored 的 search-layer（Exa + Tavily + Grok，带意图感知打分），需要旧行为时用 --legacy 或 legacy 子命令回到 Tavily + Exa + Google 合并输出。

技能如何工作

双层路由

• 默认深度层：普通查询进 search-layer 的 deep 模式；出现 --mode、--intent、--freshness、--source、--extract-refs、--domain-boost 等参数时，wrapper 会自动路由到 deep-search。
• Legacy 合并层：--legacy 保留按引擎分块的原始结果，去重链接后汇总共识、分歧与可执行的下一步。

配套子能力

• search-layer：fast|deep|answer 模式，factual|status|comparison|tutorial 等 intent，可选 domain-boost 与多源 exa,tavily,grok,tinyfish。
• fetch-thread：从线程 / issue / PR / 论坛拉深上下文。
• content-extract：URL → Markdown，失败可回退 MinerU。
• mineru-extract / mineru-parse-documents：官方 MinerU 解析封装。

深度流优先返回 vendored 工具的结构化 JSON/Markdown，再按模板归纳结论、最强依据、不确定性与后续追踪步骤。

适用边界与注意点

• Legacy 依赖本地 Tavily/Exa 配置及已安装的 Google 搜索技能；深度栈更倾向 ~/.openclaw/credentials/search-layer.env（可用环境变量覆盖）。
• 技能使用独立 venv（requests、trafilatura、beautifulsoup4、lxml）；纯 CLI 下 不会自动调用 OpenClaw 内置的 Brave web_search，与上游 README 中 agent-only 能力不一致时需心里有数。
• content-extract 与 MinerU 相关命令需要 URL 可访问；MinerU 需有效 MINERU_TOKEN。