前言¶

在 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