前言¶

在 DeepSeek Harness（DSH）裏給智能體接入 Web 搜索時，常見的問題是：不同搜索引擎的接入方式不同，免 Key 引擎與 API Key 引擎混在一起，配置、回退和持久化邏輯也容易分散。dsh-web-search-multi 把這些需求收斂到一個 DSH 插件裏：提供多提供商 Web 搜索、DuckDuckGo 全局回退，以及 DSH Web UI 中的 Web Settings UI。

這是什麼¶

dsh-web-search-multi 是面向 DeepSeek Harness 的多提供商 Web 搜索插件，由 cinob 維護，採用 MIT License。它支持 360、Bing、Baidu 等免費免 Key 直連引擎，也支持 Tavily、Brave Search、Serper/Google、Bocha AI、SearXNG 等提供商，並提供 DuckDuckGo 全局回退與 DSH Web UI 設置頁。

核心能力¶

• 免費免 Key 直連：360、Bing、Baidu。
• 免費額度提供商：Tavily（1,000/月）、Brave Search（2,000/月）、Serper/Google（2,500 次）、Bocha AI。
• SearXNG：支持私有/自託管實例，並支持 token 認證；SEARXNG_TOKEN 爲可選配置。
• 回退：DuckDuckGo 全局回退。
• Web GUI：在 DSH Web UI 中提供 Settings -> 多源 Web 搜索 設置頁，支持即時連接測試和即時持久化。
• 憑據存儲：祕密保存到 ~/.dsh/.credentials.yaml（mode 0600），非密鑰設置保存到 ~/.dsh/settings.yaml。
• 權限與風險：風險等級爲 low；網絡權限是向所選搜索提供商發起出站 HTTPS 請求。
• 兼容要求：Node.js >=20.0.0、DeepSeek Harness mainline v0.1.0+、Linux/macOS/Windows。

安裝與啓用¶

下面先執行安裝命令。該插件以 Profile Bundle 形式安裝，內置 cordis.patch.yml 會自動掛載並激活 multi-search，無需手動插入 web-search-multi。

dsh plugin --profile web add github:cinob/dsh-web-search-multi

如果之後需要移除，執行卸載命令：

dsh plugin --profile web remove dsh-web-search-multi

典型用法¶

下面介紹在 DSH Web 中啓用和配置搜索源。先啓動 Web 服務：

dsh web

然後打開 http://127.0.0.1:3080，進入 Settings -> 多源 Web 搜索。

1、選擇搜索引擎，或者保持 自動策略 (Auto)。
2、如果需要調用免費額度提供商，可選填入 TAVILY_API_KEY、BRAVE_API_KEY、SERPER_API_KEY、BOCHA_API_KEY 或 SEARXNG_TOKEN。
3、保存並進行即時測試。

適用場景與注意¶

適合以下情況：

• 希望先使用 360、Bing、Baidu 等免 Key 直連引擎。
• 已經使用 Tavily、Brave Search、Serper/Google 或 Bocha AI 的免費額度。
• 需要接入私有/自託管 SearXNG。
• 希望通過 DSH Web UI 維護搜索源、憑據和連接狀態。

注意：

• 插件會向所選搜索提供商發起出站 HTTPS 請求。
• API Key 等祕密會保存到 ~/.dsh/.credentials.yaml（mode 0600），普通設置保存到 ~/.dsh/settings.yaml。
• 插件運行在 dsh 進程上下文中，並以當前 dsh 進程權限執行；安裝前建議檢查源碼與 MIT License。
• 使用前確認環境滿足 Node.js >=20.0.0 與 DeepSeek Harness mainline v0.1.0+，平臺爲 Linux/macOS/Windows。

結尾¶

dsh-web-search-multi 的價值在於把多提供商 Web 搜索、回退邏輯和 Web 設置頁合併到 DSH 插件體系中，減少搜索源接入、配置和測試之間的切換成本。項目倉庫地址：https://github.com/cinob/dsh-web-search-multi。