用途:在需要联网获取最新资料时使用,包括查询库/框架/SDK/语言的官方文档与 API 参考、查找代码示例与教程、读取已知 URL 的网页正文、查看 GitHub 仓库结构、README 与源码入口。纯本地代码检索、无需联网的问答、需执行或调试代码、修改重构代码时应避免使用。
主要能力与工具链:按搜索目标固定使用对应工具。技术文档走 Context7,须先 resolve-library-id 再 query-docs,每问题不超过 3 次;网络搜索优先 Exa,仅在 Exa 失败、额度到限、服务不可用或空结果时按备用文档使用 TinyFish CLI;GitHub 仓库级文档走 mcp-deepwiki,具体文件或目录走 github-fetcher;网页正文读取仅在已知 URL、Exa 或 TinyFish 已定位 URL 后进行。禁止用 open-websearch 等未指定工具替代 Exa/TinyFish,禁止互相替代 mcp-deepwiki 与 github-fetcher。
使用方式:本技能通过调用参数区分模式。参数为 setup(即 $search-web setup)时执行初始化与 MCP 配置流程,完成后停止当前搜索;其他参数或无参数直接进入搜索流程,普通搜索不运行 detect.sh,也不自动安装或写入 MCP 配置。配置项类问题先读配置索引快捷文档;输出前按输出格式规则整理,并标注来源类型与保留原始链接。
限制与错误处理:普通搜索中若 Context7、Exa、mcp-deepwiki、github-fetcher 报未注册、未加载、连接失败或服务不可用,应停止搜索并提示用户运行 $search-web setup 后重启 code agent,不应反复重试。TinyFish 仅在 Exa 已调用但失败、额度到限、服务不可用或空结果时使用。Context7 必须两步调用,超过 3 次应转 Exa。发生降级、读取失败或信息不足时需说明原因,不编造未读取到的内容。宿主类型未识别时普通搜索照常进行。具体安装命令、API Key 写入及示例内容暂未在资料中提供。