前言¶

在 Agent 里做「上网」类任务时，常见做法是固定调用某一种工具：要么只用搜索 API，要么一律走浏览器。搜索适合找入口和摘要，但对单页正文、需要 JS 渲染或登录的站点往往不够；浏览器权限大、成本高，又容易在简单读 URL 时过度使用。工具一旦报错，还缺少统一的降级与重试策略。

下面介绍 SkillHub 上的 网络搜索工具·上网助手（坐标 @laoxi/adaptive-web-router-shangwangzhushou，亦称 Adaptive Web Router）。它不按单一工具硬扛所有网页需求，而是根据意图、能力、风险与成本，把任务分到 web_search、web_fetch、opencli、browser 或宿主环境中的等价能力上。

这是什么¶

网络搜索工具·上网助手 是一条面向 Agent 的 SKILL.md 类技能：用规则与策略指导模型如何选网侧工具，而不是替代宿主自带的搜索、抓取或浏览器实现。

• 维护方：劳希（SkillHub 发布者）
• 版本：1.0.2（来源标注为 enterprise）
• 分类：ai-agent
• 标签：requires_api_key=false（技能本身不要求单独配置 API Key）

它要解决的是：在多种网页相关工具并存时，如何选路、如何控制权限与重试、如何向用户说明进度并核验来源，并在网页工具故障时尝试恢复，而不是把每次请求都绑死在一种通道上。

核心功能¶

以下能力均来自 SkillHub 官方简介，安装启用后由 Agent 按技能说明执行。

任务路由¶

按用户意图与页面特征，将工作分发到：

路由时会权衡 能力是否够用、风险与成本，倾向 最小权限：能 web_fetch 解决的就不默认上浏览器。

场景覆盖¶

官方列出的适用方向包括：搜索、上网、查资料、打开网站、抓取网页、新闻与热点；网页搜索与获取当前信息；读取 URL；结构化站点访问；需要 JS 渲染或登录的页面；截图与网页交互；以及 从网页工具故障中恢复。

优化目标¶

技能说明中强调的实践目标包括：

1. 最小权限：按任务选工具，避免不必要的浏览器或高权限操作。
2. 有限重试：失败时有界重试，而不是无限循环调用。
3. 简洁的用户进度说明：执行过程中用简短说明当前在做什么。
4. 来源核验：对来自网络的结论注意可追溯与核对。
5. 平台兼容性：在 Cursor、Codex、Claude Code 等具备不同工具集的宿主上，优先使用 宿主等价工具，而不是假设某一固定运行时。

明确不做的事¶

• 不用于纯本地文件任务（读仓库、改本地配置等应走文件类工具）。
• 不会自动安装软件（例如不会替你装浏览器或 CLI）。

安装与启用¶

SkillHub 页面给出的安装方式是：让 Agent 依照官方安装文档，安装坐标 @laoxi/adaptive-web-router-shangwangzhushou。

1、准备 SkillHub CLI（若尚未安装）¶

先检查是否已有 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（文档推荐）或仅安装 CLI：

# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装说明全文见：https://skillhub.cn/install/skillhub.md。

2、安装本技能到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向 当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 可能不会被识别。

skillhub install @laoxi/adaptive-web-router-shangwangzhushou --dir <skills 目录>

常用路径（以 SkillHub 安装文档为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可在 SkillHub 技能页将安装提示词发给 AI，由 Agent 按上述文档完成安装。装好后按你所用客户端的要求刷新或重启 Agent，使技能生效。

典型用法¶

本技能没有单独的「业务 API」，启用后体现在 对话中的上网类请求 上。Agent 会按 SKILL 中的策略选择工具链，而不是由用户手动指定 web_search 或 browser。

可复现的交互方式示例（表述因宿主而异，逻辑一致）：

1. 查资料 / 热点：例如「最近某话题的权威来源有哪些？」——优先搜索类能力汇总入口，再按需抓取具体 URL。
2. 读指定链接：给出完整 URL，要求总结正文——在静态页场景优先 web_fetch 类能力；若内容依赖前端渲染，再升级到 browser。
3. 需要交互或登录的页面：明确说明需要登录、点击或截图时，路由偏向 browser，并配合有限重试与进度说明。
4. 工具失败后恢复：某次 web_fetch 失败时，技能指导 Agent 换通道或降级/升级工具，而不是重复同一失败调用。

具体每一步调用哪类工具，以安装后的 SKILL.md 与宿主已注册的工具名为准。

适用场景与注意¶

适合谁¶

• 经常在 Agent 里做 搜索、读网页、跟热点，又不想自己维护一长串「先用 A 再用 B」的提示词的团队或个人。
• 使用 Cursor、Codex CLI、Claude Code 等环境，且已具备或计划配置 web_search、web_fetch、browser 等能力（或宿主等价物）的开发者。

使用注意¶

1. 依赖宿主工具：技能是路由与策略层；若宿主未提供 browser 或抓取能力，对应分支无法 magically 补齐。
2. 权限与合规：浏览器与登录场景涉及账号与站点条款，仍需人工确认；技能强调最小权限，但不替代你的合规判断。
3. 与本地任务边界：仓库内读文件、跑测试、改代码不要指望本技能处理。
4. 数据以 SkillHub 为准：评分、下载量等会随时间变化；查阅时以技能页实时信息为准。

结尾¶

网络搜索工具·上网助手（Adaptive Web Router）把「上网」从单一工具调用变成 可路由、可降级、可恢复 的策略：在搜索、抓取、CLI 与浏览器之间按意图与成本选型，并兼顾来源核验与跨平台兼容。若你希望在 Agent 里稳定处理查资料、读 URL 和复杂页面，可以从 SkillHub 安装 @laoxi/adaptive-web-router-shangwangzhushou（v1.0.2）。

• SkillHub 技能页：https://www.skillhub.cn/skills/laoxi/adaptive-web-router-shangwangzhushou
• API 入口：https://api.skillhub.cn/laoxi/adaptive-web-router-shangwangzhushou