前言¶

DeepSeek Harness 的插件生態允許開發者擴展功能。在使用非官方 DeepSeek API（例如 GLM 或網關）時，默認的內置 web_search 工具常因鑑權配置問題返回 401 錯誤，導致無法完成聯網檢索。dsh-plugin-search 插件專門針對這一場景，提供了一套無需複雜配置的解決方案。

插件定位¶

dsh-plugin-search 是一個爲 DeepSeek Harness 設計的聯網工具插件，由用戶 shinjiyu 維護。其核心定位是在不依賴官方 DeepSeek API 的環境下，通過零配置的方式接管 web_search 工具，繞過鑑權限制，實現正常的網頁搜索。

核心功能¶

• 零配置啓動：安裝後無需額外配置即可運行。
• 接管內置工具：自動關閉官方的 web-search-deepseek 機制，避免衝突。
• 保持兼容性：工具名稱保持爲 web_search，與現有工作流無縫銜接。
• 支持無 Key 模式：默認支持 Tavily 的 keyless 模式，無需 API Key 即可使用。
• 修復鑑權錯誤：正確配置後，將返回搜索結果鏈接，而非 401 錯誤。

安裝與啓用¶

1. 執行以下命令安裝插件：

dsh plugin --profile web add github:shinjiyu/dsh-plugin-search

2. 安裝完成後，重啓 dsh web 進程。

注意：舊會話的工具表在重啓後不會自動更新，新會話將自動使用新插件。

典型用法¶

1. 環境變量配置：

   • 如果擁有 Tavily 賬號，請設置環境變量 TAVILY_API_KEY。
   • 如果沒有賬號，保持不設置該變量，插件將使用 keyless 模式。

2. 模型與 Key 設置：

   • 確保主模型使用的是非官方 DeepSeek API（如 GLM 或網關）。
   • 不要設置 DEEPSEEK_API_KEY。

3. 功能驗證：

   • 在對話中詢問關於 DeepSeek Harness Discussions 的最新內容。
   • 若插件生效，web_search 將返回搜索結果鏈接，而非 401 錯誤。

注意事項¶

• 不要修改系統文件：請勿修改 runtime/ 目錄或官方的 web-search-deepseek 插件文件。
• 定位限制：請勿將其宣傳爲搜索引擎全家桶。
• 社區狀態：對應的微信羣二維碼已於 2026-08-22 過期。
• 會話更新：舊會話的工具表不會在重啓後自動更新，需開啓新會話。

結尾¶

dsh-plugin-search 解決了在使用第三方 API 時 web_search 被鑑權限制的痛點。項目基於 MIT 許可證開源，源碼託管在 GitHub，供需要集成第三方 DeepSeek 服務的開發者參考。

• 項目主頁：https://github.com/shinjiyu/dsh-plugin-search