前言¶
在 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_search |
网页搜索、新闻、热点、获取当前信息的检索入口 |
web_fetch |
读取 URL、抓取网页正文、结构化站点访问（静态或可直抓内容） |
opencli |
宿主或 CLI 侧与网络相关的等价能力 |
browser |
JS 渲染页面、需登录站点、截图、网页交互 |
路由时会权衡 能力是否够用、风险与成本，倾向 最小权限：能 web_fetch 解决的就不默认上浏览器。
场景覆盖¶
官方列出的适用方向包括：搜索、上网、查资料、打开网站、抓取网页、新闻与热点；网页搜索与获取当前信息；读取 URL；结构化站点访问；需要 JS 渲染或登录的页面；截图与网页交互；以及 从网页工具故障中恢复。
优化目标¶
技能说明中强调的实践目标包括：
- 最小权限：按任务选工具，避免不必要的浏览器或高权限操作。
- 有限重试：失败时有界重试，而不是无限循环调用。
- 简洁的用户进度说明：执行过程中用简短说明当前在做什么。
- 来源核验：对来自网络的结论注意可追溯与核对。
- 平台兼容性：在 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。
可复现的交互方式示例（表述因宿主而异，逻辑一致）：
- 查资料 / 热点：例如「最近某话题的权威来源有哪些？」——优先搜索类能力汇总入口，再按需抓取具体 URL。
- 读指定链接：给出完整 URL，要求总结正文——在静态页场景优先
web_fetch类能力；若内容依赖前端渲染，再升级到 browser。 - 需要交互或登录的页面：明确说明需要登录、点击或截图时，路由偏向 browser，并配合有限重试与进度说明。
- 工具失败后恢复：某次
web_fetch失败时，技能指导 Agent 换通道或降级/升级工具，而不是重复同一失败调用。
具体每一步调用哪类工具，以安装后的 SKILL.md 与宿主已注册的工具名为准。
适用场景与注意¶
适合谁¶
- 经常在 Agent 里做 搜索、读网页、跟热点，又不想自己维护一长串「先用 A 再用 B」的提示词的团队或个人。
- 使用 Cursor、Codex CLI、Claude Code 等环境，且已具备或计划配置
web_search、web_fetch、browser 等能力（或宿主等价物）的开发者。
使用注意¶
- 依赖宿主工具：技能是路由与策略层；若宿主未提供 browser 或抓取能力，对应分支无法 magically 补齐。
- 权限与合规：浏览器与登录场景涉及账号与站点条款，仍需人工确认；技能强调最小权限，但不替代你的合规判断。
- 与本地任务边界：仓库内读文件、跑测试、改代码不要指望本技能处理。
- 数据以 SkillHub 为准：评分、下载量等会随时间变化；查阅时以技能页实时信息为准。
结尾¶
网络搜索工具·上网助手（Adaptive Web Router）把「上网」从单一工具调用变成 可路由、可降级、可恢复 的策略：在搜索、抓取、CLI 与浏览器之间按意图与成本选型，并兼顾来源核验与跨平台兼容。若你希望在 Agent 里稳定处理查资料、读 URL 和复杂页面，可以从 SkillHub 安装 @laoxi/adaptive-web-router-shangwangzhushou（v1.0.2）。
