前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在使用 Web 搜索能力時,通常需要針對不同場景配置特定的搜索引擎。dsh-web-search-multi 插件解決了這一問題,它允許在 DSH 內部直接配置 SearXNG、Brave、Tavily、Gemini 和 Wikipedia 等多個搜索提供商,並使用 DSH 原生的 web_search 工具。
核心功能¶
- 多提供商支持:提供 SearXNG、Brave、Tavily、Gemini 和 Wikipedia 五種搜索後端。
- 獨立開關:在對話界面,每條消息行都包含搜索開關,可獨立啓用或禁用當前會話的搜索功能。
- 零配置起步:默認 Wikipedia 後端無需 API 密鑰即可使用。
- 精準路由:僅向選定的提供商發送查詢,無隱式回退機制。
安裝與啓用¶
-
環境準備
- 確保系統已安裝 Node.js
^22.19或>=24。 - 確認 DeepSeek Harness 版本。插件
0.2.3要求 DSH 版本爲0.1.5-rc.2。如果使用舊版 DSH (0.1.1-rc.2),需安裝插件0.2.0。
- 確保系統已安裝 Node.js
-
安裝插件
執行以下命令將插件添加到web配置文件中:
dsh plugin --profile web add dsh-web-search-multi@latest
安裝完成後重啓 `dsh web` 服務。
配置與使用¶
Web 界面配置¶
安裝後,在 Web 界面進入 Settings → Plugins → Plugin configuration → Multi-provider web search。
* 選擇一個默認提供商(如 Wikipedia、Brave 或 SearXNG)。
* 如果需要,配置提供商的憑證或 SearXNG 的訪問地址。
* 點擊 Test configuration 運行一次真實查詢以驗證設置是否成功。
會話內控制¶
在對話界面的 Composer 工具欄,每一行都有一個兩部分的藥丸控件。
* 左側控制開關狀態(Off / On)。
* 選擇 Off 會從該會話的可用工具列表中移除 web_search,並阻止直接調用。
* 此開關不影響 web_fetch 或 Grok Build 自帶的搜索功能。
文件配置¶
對於高級配置,可以編輯配置文件 $DSH_HOME/profiles/web/cordis.patch.yml。該文件會完全替換頂層的 config 值,請保留所選示例中所有必需的鍵。
注意事項¶
- 版本兼容性:插件
0.2.0及以下版本基於舊的設置 API,與0.1.5-rc.2之後的 DSH 不兼容。 - SearXNG 部署:該插件不負責安裝或啓動 SearXNG 服務。如需使用 SearXNG,需自行部署 Docker 容器或實例。
- 安全性:請勿在未進行身份驗證、速率限制或添加其他安全措施的情況下,將 SearXNG 或 API 密鑰配置項公開展示。
- 知識範圍:默認的 Wikipedia 後端僅提供百科全書知識,不涵蓋實時網絡信息。
總結¶
該插件通過提供靈活的多後端配置和會話級控制,增強了 DeepSeek Harness 在 Web 搜索方面的適應能力。對於需要整合多種搜索源或控制搜索成本的場景,這是一個實用的工具。