前言¶
在 DeepSeek Harness (DSH) 的插件化生態中，讓智能體具備聯網能力是提升實用性的關鍵。開發者經常需要查詢文檔、搜索代碼示例、分析開源項目或調試錯誤信息。傳統的做法是手動複製粘貼 URL 到瀏覽器，效率較低。
xby-web-research-assistant 是一個提供網絡研究和發現功能的綜合模型上下文協議（MCP）服務器。它通過 13 種工具，將搜索、爬取和分析網絡內容的能力直接嵌入到 DSH 的對話流中，省去了手動跳轉和複製文本的步驟。
功能概覽¶
該插件提供以下核心能力：
- set_xby_apikey：在對話中設置 API 密鑰，該密鑰會自動持久化，重啓後依然有效。
- web_search：通過本地 SearXNG 實例獲取新鮮的網絡搜索結果。
- crawl_url：使用 crawl4ai 獲取目標頁面的完整文本，用於引用或深度分析。
- package_info：查詢 npm、PyPI、crates.io 等倉庫的包信息，包括版本、下載量、依賴和安全狀態。
- search_examples：搜索代碼示例、教程和文章，支持按內容類型和時間範圍篩選。
- search_images：通過 Pixabay 搜索免版稅圖片（照片、插圖、矢量圖）。
- package_search：根據關鍵詞或描述在多個註冊表中搜索包，適合發現庫。
- github_repo：獲取 GitHub 倉庫的詳細信息，包括星標、問題、語言和最近活動。
- translate_error：解析錯誤信息或堆棧跟蹤，自動定位到 Stack Overflow 或 GitHub 上的解決方案。
- api_docs：自動發現並抓取官方 API 文檔，提供示例和最佳實踐。
- extract_data：從 HTML 頁面中提取結構化數據，支持表格、列表、特定字段或 JSON-LD。
- compare_tech：對多個技術、框架或庫進行並排對比。
- get_changelog 與 check_service_status：分別獲取包的更新日誌和檢查服務狀態。
安裝與啓用¶
安裝該插件需要先在小笨羊官網註冊並獲取 API 密鑰。安裝命令如下：
dsh plugin --profile web add github:xby_skill/xby-web-research-assistant
安裝完成後，插件會在當前 DSH 進程中生效，工具將自動映射到可用的 MCP 節點上。
典型用法¶
以下是該插件在技術場景中的具體應用示例：
1. 查詢包信息
在引入新庫前，快速評估其版本、依賴和安全狀況。
package_info("express", reasoning="Need web framework", registry="npm")
2. 搜索代碼示例
尋找特定的 API 用法或教程，支持篩選代碼或文章內容。
search_examples("FastAPI dependency injection examples", content_type="code")
3. 錯誤調試
遇到報錯時，自動翻譯錯誤信息並查找解決方案。
translate_error("TypeError: Cannot read property 'map' of undefined", reasoning="Debugging React app crash")
4. 技術選型對比
在決定使用 React、Vue 還是 Svelte 時，獲取並排對比數據。
compare_tech(["React", "Vue", "Svelte"], reasoning="Choose framework for new project")
5. 抓取頁面數據
從指定 URL 提取結構化數據，如產品詳情或發佈列表。
extract_data("https://pypi.org/project/fastapi/", reasoning="Get package info")
注意事項¶
- API 密鑰依賴：所有高級功能均依賴於小笨羊提供的 API 密鑰，未配置密鑰時部分功能可能受限。
- 本地實例：web_search 功能依賴本地運行的 SearXNG 實例，需確保該服務正常運行。
- 權限與來源：插件通過 DSH 進程運行，使用時請確保瞭解其網絡請求行爲。所有工具均基於開源或公開接口，使用前請參考其許可證（MIT）。
結語¶
xby-web-research-assistant 將複雜的網絡操作封裝爲 13 個具體的工具函數，極大地降低了智能體獲取外部信息的門檻。通過集成搜索、文檔抓取和數據分析能力，開發者可以專注於業務邏輯，而將繁瑣的信息檢索工作交給插件處理。
