前言¶

DeepSeek Harness（DSH）可以通過插件擴展工具能力。對於聯網場景，開發者可能需要多搜索源自動回退、無密鑰兜底，以及把網頁正文提取爲可讀文本。haibinwang9/dsh-web-search 就是用於補齊這類聯網能力的插件。下面介紹它的功能、安裝、配置和注意事項。

這是什麼¶

dsh-web-search 由 haibinwang9 維護，許可證爲 MIT。它圍繞 DSH 的聯網能力提供兩件事：

• 搜索：驅動內置 web_search 工具，按 SearXNG → Tavily → Brave → DuckDuckGo 順序回退。
• 抓取：提供 get_search_content 工具，用於抓取 URL 並提取可讀正文。

插件還會補齊 fetch seam，註冊搜索和抓取兩個 provider，使內置 web_fetch 恢復可用。

核心功能¶

多引擎搜索自動回退¶

在插件回退鏈中，已配置的搜索引擎按順序使用，未配置的搜索引擎會自動跳過。若沒有配置 SearXNG、Tavily、Brave，DuckDuckGo 可以作爲零配置兜底。

URL 正文提取¶

get_search_content 用於抓取指定 URL，並將網頁內容轉換爲可讀純文本。經過上面的配置後，可以先用 web_search 找到頁面，再用 get_search_content 讀取正文。

設置頁切換默認搜索引擎¶

設置頁提供默認搜索引擎開關：

• 開啓：使用 dsh-web-search 的回退鏈。
• 關閉：委託官方 DeepSeek 搜索。

補齊 fetch seam¶

插件註冊搜索 provider 和抓取 provider。這樣，內置 web_fetch 可以恢復可用。

配置集中到設置頁¶

SearXNG、Tavily、Brave 的密鑰可以寫入 credentials 服務。取值優先級爲：環境變量優先，其次爲 harness credentials 服務；也可以寫入 ~/.dsh/.credentials.yaml。

安裝與啓用¶

版本與依賴¶

package.json 中聲明版本爲 0.1.2，運行環境要求 node >=20。peerDependencies 要求：

@deepseek-ai/dsh-tools ^0.1.0-rc.6
@deepseek-ai/dsh-credentials ^0.1.0-rc.6
@deepseek-ai/dsh-web-search-deepseek ^0.1.0-rc.6

先確認當前 DSH 環境滿足上述 peer 依賴，再執行安裝。

安裝命令¶

使用插件安裝命令：

dsh plugin --profile web add dsh-web-search

如果從源碼安裝，先獲取倉庫，再安裝本地目錄：

git clone https://github.com/haibinwang9/dsh-web-search.git
cd dsh-web-search && dsh plugin --profile web add .

啓用配置¶

安裝後重啓 DSH，然後進入：

設置 → 插件 → Web access

在設置頁配置開關和密鑰。相關配置項包括：

PIWA_SEARCH_ENABLED
SEARXNG_BASE_URL
TAVILY_API_KEY
BRAVE_API_KEY

其中 PIWA_SEARCH_ENABLED 控制是否使用插件回退鏈；其餘三項分別對應 SearXNG、Tavily、Brave 的地址或密鑰。

典型用法¶

下面是一條基本使用路徑：

1、執行安裝命令，安裝 dsh-web-search。
2、重啓 DSH。
3、在 設置 → 插件 → Web access 中開啓 PIWA_SEARCH_ENABLED。
4、按需填寫 SEARXNG_BASE_URL、TAVILY_API_KEY、BRAVE_API_KEY；未填寫的引擎會自動跳過。
5、在 DSH 中使用 web_search 進行搜索，需要讀取具體頁面時使用 get_search_content。

適用場景與注意¶

適合以下場景：

• 需要多個搜索引擎自動回退。
• 希望在沒有配置密鑰時仍有 DuckDuckGo 兜底。
• 需要把 URL 正文提取爲可讀文本，供後續閱讀或處理。

注意：

• 插件以當前 DSH 進程權限運行。安裝前建議檢查源碼、許可證和依賴關係。
• 搜索引擎密鑰會用於網絡訪問，配置前確認來源和權限範圍。
• 許可證爲 MIT。搜索與正文提取邏輯改編自 nicobailon/pi-web-access（MIT）。
• package.json 版本爲 0.1.2；如 DSH 側 peer 依賴不滿足，應先確認環境版本。

獲取信息¶

• GitHub：https://github.com/haibinwang9/dsh-web-search
• 目錄頁：https://www.skillhub.cn/plugins/haibinwang9/dsh-web-search