Websearch enhanced

WebSearch Enhanced

流程：Step 1 搜索简报 → Step 2 配置 → Step 3 降级链执行 → Step 4 综合引用。每步完成标准写在步尾。

Step 1 — Search Intent Brief（每次触发必做）

调用任何搜索引擎之前，先产出搜索简报（内部思考即可；复杂任务可展示给用户确认）：

1. Goal：一句话写完"搜索成功，我就能回答 ____"。写不出就先向用户澄清。
2. 类型（单选主类型，决定子模式）：fact 单点事实 / news 时效新闻 / research 多源深度综合 / extract 已有 URL 读正文 / vertical 垂直域（金融行情、学术、专利、CVE、旅行、法规等）。
3. 约束：时间范围、语言与地域、信源偏好（官方 > 媒体 > 社区）。
4. 查询拆解：1–N 条互不重叠的子查询，每行 查询词 | 类型 | 期望拿到什么。fact 1 条；research 3–6 条覆盖不同角度（现状/数据/机制/对立观点/最新进展）。
5. 验收：每条子查询写明"什么结果算够"（例：含具体数字的官方公告 + 1 条独立佐证）。

查询词纪律：写搜索词不写提示词——去客套和指令语气，留实体 + 关键限定，单条 <400 字符；跨语言主题中英各备一条；时效主题在查询词里加时间锚点（年份/月份），不只依赖过滤器。

完成标准：五项齐全，每条子查询都有验收条件。

Step 2 — 配置（首次运行必自检）

三家 provider 均为必装——缺一级，降级链就断一截。首次使用先跑自检：

${KIMI_SKILL_DIR}/scripts/check_deps.sh   # 检查三家 key + CLI，缺失项附补齐指引
source ${KIMI_SKILL_DIR}/scripts/env.sh   # 导出 ANYSEARCH_API_KEY / TAVILY_API_KEY / EXA_API_KEY

${KIMI_SKILL_DIR} 即本技能根目录（kimi code 原生展开；其他 runtime 不展开时替换为实际路径）。Key 优先级三家一致：环境变量 > skill 根目录 .env。

自检有缺失 → 把缺失项和补齐方式告知用户并请其配置；用户明确暂不补的级才跳过，并在最终答复注明。AnySearch 匿名访问（低配额）仅作应急，不算配置完成。

完成标准：自检全绿；或缺失项已报告用户并拿到处理决定。

Step 3 — 降级链执行

按 AnySearch → Tavily → Exa → 内置网页搜索 固定顺序逐级下落（用户点名某家则从该家起，其后仍按序）。

两种触发，两种动作：

触发	动作
结果不满足验收条件	同级重写查询词再试 1 次；仍不够 → 降级
调用失败（401/403 认证、429 配额、超时/5xx、CLI 不可用）	重试 1 次；仍失败 → 立即降级，不再重写

配额纪律：三家都是固定配额，"失败即降级"正是为了不把配额烧在坏源上——每条子查询每级最多 2 次查询（首查 + 1 次重写）、错误最多 1 次重试，到量立刻走。每次降级记下原因（如 tavily: 429 配额耗尽）；落到内置搜索或链路穷尽时，在答复中说明各级状态与原因。

场景路由（按 Brief 类型选子模式；命令语法不在本文件——调用某级前先读对应 provider 文档）：

Brief 类型	AnySearch	Tavily	Exa
fact 通用	search（有域交集先走 vertical）	search	type auto
vertical	get_sub_domains → domain search（默认路径）	search --topic	category
news	search + 时间锚点	search --time-range --topic news	category news + 日期过滤
research	batch_search 多角度并行	research（30–120s）	type deep + highlights
extract	extract	extract	/contents
整站/批量	不支持，直接降级	map → crawl	/contents + subpages

Provider 文档（用到哪级读哪份）：anysearch.md / tavily.md / exa.md。内置搜索无需文档。

成本纪律：research/deep 模式仅 research 类意图使用；fact 永远用最快档。

完成标准：每条子查询满足其验收条件，或链路穷尽且已说明。

Step 4 — 综合与引用

• 每条关键事实标来源（标题 + URL + 发布/抓取日期）与 provider；同一 URL 去重。
• 关键数字/结论两个独立信源交叉验证；冲突并列呈现，不擅自仲裁。
• snippet 不足以定论时，用 extract 模式读正文再答。
• 先一两句直接回应 Goal，再展开证据；区分"搜索到的"与"我的推断"。

完成标准：每条关键事实可溯源。

安全约定

• Key 只存在于环境变量或本地 .env（gitignore、chmod 600）；聊天中收到 key 写入 .env，不回显、不写入任何会被提交的文件。
• 含密码、个人隐私、商业机密的查询词不发给任何外部搜索服务。
• scripts/ 为 AnySearch 上游 vendor（Apache-2.0，见 scripts/ANYSEARCH-LICENSE）；Tavily/Exa 为官方 CLI/REST 的文档级集成，二次分发保留出处。