技能介绍

解决什么问题

开发者排查问题时，搜索引擎返回的结果里总夹着大量 SEO 农场和过时转载。真正有用的链接——官方文档的某一版、GitHub 上某个 issue 的讨论、某个库的 API 签名——被埋在一堆广告和低质量博客下面。

中文社区的情况更糟。同一个 useEffect 清理逻辑，你可能想看 React 官方文档，也可能想翻掘金或博客园上的真实踩坑记录，但在一个搜索框里很难精确限定来源。

它如何工作

这个技能提供 14 个 ai_search_* 函数，按目标站点分成不同工具：通用网页、GitHub、StackOverflow、NPM、框架文档、API 参考、微信开发者文档，以及 CSDN、掘金、SegmentFault、博客园、开源中国、阿里云文档、腾讯云文档。

几个关键设计值得注意：

模型只负责路由和参数提取。 你理解用户意图、选工具、抽参数，代码只负责调 API。调用方式是关键字参数，例如 scripts.tools.ai_search_github(query='vite ssr', sort='stars')。
工具返回的是搜索 URL，不是结果本身。 拿到 URL 后要用 WebFetch 访问才能拿到真实内容。这意味着它不替代抓取，而是把「去哪搜」这一步结构化了。
每个工具有针对性参数。 GitHub 支持 language 筛选和 sort；StackOverflow 支持 tags；阿里云和腾讯云文档支持 product，可以限定到 ecs 或 cvm 这类具体产品。
返回值是字典，包含 raw（API 原始 JSON）、success 和 message。拿到 raw 后需要整理再展示给用户。

适用边界

必须配置 API 密钥。 首次使用时如果 .env 里没有 XBY_APIKEY，技能会通过 AskUserQuestion 向用户询问密钥，然后调用 scripts.config.set_api_key(api_key) 保存。密钥在 https://xiaobenyang.com 获取。

缺少密钥时，技能不会自行搜索或编造数据——这是它的硬约束。如果你在自动化流程里用这个技能，需要提前把密钥配好，否则每次调用都会卡在询问这一步。

参数不完整时，技能同样会询问用户补全，而不是猜测。这对交互式使用是优点，对批量脚本来说是需要注意的行为。

最后，因为它只返回搜索 URL，真正读取页面内容还要靠 WebFetch。如果你的场景里网页抓取本身受限或不稳定，这个技能的端到端效果会打折扣。