DeepSeek Harness (DSH) 內置的 web_search 工具依賴付費提供商。dsh-web-search-router 插件在 DSH 中註冊了一個 multi-search 提供商。它首先嚐試無密鑰並行搜索，然後根據需要或提供者失敗回退到配置的搜索 API。
核心功能¶
該插件提供以下能力：
- 無密鑰並行搜索作爲第一路由：使用 Parallel 的 Keyless Parallel 端點。
- 可選回退提供商：支持 Tavily, Exa, Brave Search, Serper, 和 SerpApi。
- 動態回退排序：根據估算的免費容量和觀測到的延遲對回退提供商進行排序。運行時測量可能會改變此順序。
- 實時額度刷新：刷新 Tavily 和 SerpApi 賬戶使用情況，以及 Brave 響應頭額度。
- 提前退出：一旦收集到足夠的唯一結果，立即停止。
- 結果處理：URL 規範化，去重，以及倒數排名融合 (RRF)。
- 提供者冷卻：速率限制，配額，認證或瞬時錯誤後的冷卻。
- 僅寫入 API 密鑰：在 DSH 設置頁面中管理密鑰。
- 無付費依賴：不依賴 DeepSeek 的付費 Web 搜索提供商。
安裝與啓用¶
- 進入 DSH Web 配置目錄：
cd ~/.dsh/profiles/web
- 使用 pnpm 安裝 GitHub 倉庫：
pnpm add github:chenyuhao0628/dsh-web-search-router
- 編輯該配置目錄下的
package.json，在dsh.profile.bundles中添加依賴項：
{
"dsh.profile.bundles": ["dsh-web-search-router"]
}
- 重啓 DSH。
- 在 Web 搜索提供商選擇中，確保選擇了
multi-search。
典型用法¶
在 DSH 設置中，選擇 multi-search 作爲網絡搜索提供商。如果需要，可以在設置中輸入 Tavily, Exa, Brave Search, Serper, 或 SerpApi 的 API 密鑰。插件會在後臺自動處理路由、去重和排名。
注意事項¶
- 安全性：API 密鑰由 DSH 設置頁面管理，不存儲在 Cordis 配置或此倉庫中。請勿將憑據放入
package.json、提交記錄、問題報告或截圖中。瀏覽器狀態端點僅接收規範化後的額度元數據；第三方賬戶負載和解析後的憑據值不會跨此邊界。 - 額度管理：Tavily 和 SerpApi 支持實時刷新，Exa 和 Serper 目前使用進程本地估算（因爲它們不公開餘額端點）。
- 冷卻機制：提供者在遇到錯誤後會進入冷卻狀態（例如：HTTP 429 爲 10 分鐘，配額耗盡爲 6 小時，認證失敗爲 1 小時）。
結語¶
dsh-web-search-router 提供了一個靈活、免費的搜索路由替代方案，適合需要回退或管理多個搜索提供商的場景。作者爲 chenyuhao0628，許可證爲 MIT。
