学以致用

要解决什么问题

Agent 在联网取数时，常见误区是把 web_search、web_fetch、opencli、browser 当成「从轻到重」的固定梯子，失败就一路静默降级。结果是：搜索没配 Key 时用户不知道该怎么修；静态页被 403 时过早开浏览器；需要登录或点按钮时却还在反复 web_fetch。

本技能把四类工具定义为 ReAct 下的分支决策：先按场景选对入口，再在明确信号下切换，且 每次换工具都要向用户说明原因。

如何工作

• 无 URL、要搜信息：用 web_search；返回的链接再按页面性质选 web_fetch、opencli 或 browser 深入。
• 已知 URL、静态内容（文档、博客、RSS、API）：优先 web_fetch；空白页、403、CAPTCHA、骨架 HTML → 先试 opencli，再考虑 browser。
• opencli：在 search/fetch 失败或不适用时作为 优先于 browser 的兜底，面向 70+ 站点的结构化抓取；首次 command not found 需走安装脚本（幂等）。
• browser：最后手段——SPA/动态流、登录态、表单与翻页、截图，以及其它工具全部失败时。

web_search 报错时 不得静默降级：按参考文档引导配置 API Key；用户明确「暂不配置」后，才用常用站 URL + web_fetch，再不行再上 browser。

浏览器侧强调：登录前须用户确认；发帖/删/付等须二次确认；用元素等待而非固定 sleep；验证码无法自动处理时要说明需人工介入；多步操作复用同一浏览器上下文。

适用边界

• 不是「永远用最轻工具」，而是 场景匹配 + 可解释的失败升级。
• opencli 与 browser 有环境与交互成本，不应作为默认首选项。
• 涉及账号与不可逆操作时，流程优先于自动化完成度。