前言¶
Agent 回答時效性問題，往往受限於模型訓練數據與內置工具。若要在對話裏直接拿到網頁標題、鏈接和摘要，並支持站內檢索、時間範圍過濾，通常要自行對接搜索 API、寫調用邏輯，再塞進 Skill 規範。下面介紹 SkillHub 上的 TSMAI聯網搜索（座標 @user_ccf72f3e/tsmai-search），它把騰訊雲聯網搜索能力封裝成標準 Skill，面向「查新聞、查資料、按站點搜」等常見需求。
這是什麼¶
TSMAI聯網搜索 是社區來源（community）的 ai-agent 類 Skill，當前版本 1.0.0，由發佈者 user_ccf72f3e 維護；SkillHub 頁面標註作者爲 aslinwang。
一句話定位：基於 騰訊混元 SearchPro API 的聯網搜索工具，爲 Agent 提供實時網頁檢索，結果形態包含標題、URL、摘要等，並支持自然語言檢索、多模態 VR 結果、站內搜索與時間範圍過濾。
官方入口：
- API 地址：https://api.skillhub.cn/user_ccf72f3e/tsmai-search
- SkillHub 頁面：https://www.skillhub.cn/skills/user_ccf72f3e/tsmai-search
核心功能¶
以下能力均來自 SkillHub 公開簡介，未在資料中出現的細節不展開。
- 實時聯網搜索：通過 SearchPro 拉取當前網頁信息，而非僅依賴模型記憶。
- 自然檢索：用自然語言描述檢索意圖，由 Skill 側對接搜索能力。
- 多模態 VR 結果：簡介中寫明支持多模態 VR 類結果（具體展示形態以安裝後的 Skill 說明爲準）。
- 站內搜索：在指定站點範圍內檢索。
- 時間範圍過濾：按時間條件收窄結果。
- 結構化輸出：適用於需要標題、鏈接、摘要的場景。
Skill 標籤含 requires_api_key=true，使用前需準備騰訊雲 / 混元 SearchPro 相關 API 密鑰，並按 Skill 包內說明配置（安裝後查看該 Skill 目錄下的 SKILL.md 或同類文檔）。
官方建議的觸發場景與話術包括：
- 用戶要查實時信息、最新新聞或文章；
- 需要帶標題、URL、摘要的搜索結果；
- 要做站內搜索；
- 常見觸發語：「搜索」「聯網搜索」「查一下」，或英文
search、web search、find information。
安裝與啓用¶
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 官方安裝文檔執行完整安裝（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、安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法加載。
skillhub install @user_ccf72f3e/tsmai-search --dir <你的 skills 目錄>
也可將下面提示交給支持 SkillHub 的 AI，由其按官方安裝文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝
@user_ccf72f3e/tsmai-search。
3、各客戶端 skills 目錄（參考）¶
SkillHub 文檔給出的常見路徑如下，請按你實際使用的客戶端選擇：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安裝到正確目錄後，按所用 Agent 的要求重啓或刷新 Skill 列表。API Key 的配置項名稱與取值方式以安裝包內文檔爲準。
典型用法¶
本 Skill 採用通用 SKILL.md 格式，具體工具名與參數以安裝後的文件爲準。從官方簡介可復現的用法模式如下。
- 實時信息查詢：在對話中說明要查的主題，並使用觸發語（如「聯網搜索一下……」），由 Agent 加載本 Skill 後調用 SearchPro。
- 新聞與文章：明確要求「最新」或時間範圍，配合 Skill 的時間過濾能力。
- 站內搜索：說明目標站點與關鍵詞，對應簡介中的 site-specific searches。
- 結構化結果：需要列表化展示時，說明要標題、鏈接與摘要，與 Skill 設計目標一致。
適用場景與注意¶
適合誰
- 已在 Cursor、Claude Code、Codex 等環境使用 Skill，且需要國內可落地的聯網搜索封裝；
- 願意使用騰訊雲混元 SearchPro，並能自行申請與保管 API Key 的開發者或團隊。
限制與注意
- 依賴外網搜索 API，需有效密鑰；標籤已標明
requires_api_key=true。 - 社區 Skill，升級與維護節奏取決於發佈者；安裝前可在 SkillHub 查看版本（當前 1.0.0）與頁面信息。
- 多模態 VR、時間過濾等高級能力的邊界以 SearchPro 與 Skill 文檔爲準，本文不臆測未公開的配額或計費。
結尾¶
TSMAI聯網搜索 把騰訊混元 SearchPro 的聯網檢索能力收斂成 Agent 可直接調用的 Skill，減少自研搜索橋接的工作量。若你的場景是實時網頁信息、新聞檢索或站內搜索，可在 SkillHub 安裝 @user_ccf72f3e/tsmai-search，配置 API Key 後按對話觸發即可。
官方頁面：https://www.skillhub.cn/skills/user_ccf72f3e/tsmai-search
