@deads-inc/dsh-web-search-brave：Brave Search 後備的 DSH 聯網工具

DeepSeek Harness（dsh）通過 ctx.web seam 提供聯網能力。@deads-inc/dsh-web-search-brave 插件通過註冊 WebSearchProvider 實現 Web 搜索功能，使內置的 web_search 工具能夠使用 Brave Search API。

核心能力¶

該插件主要提供以下功能：

• 註冊 Provider：將 WebSearchProvider 註冊到 ctx.web seam。
• 工具支持：支持內置的 web_search 工具。
• 併發控制：通過進程內串行化請求實現併發安全的速率限制，默認請求間隔爲 1500ms。
• 錯誤重試：遇到 429/403 狀態碼時，執行指數退避與抖動策略，最多重試 3 次，單次退避上限 30s。
• 靈活配置：支持通過 DSH 設置或環境變量進行配置。

安裝與啓用¶

1. 安裝插件

使用 npm 安裝（推薦）：

dsh plugin --profile web add @deads-inc/dsh-web-search-brave

2. 配置 API Key

插件需要 BRAVE_API_KEY 才能運行。在重啓 dsh 之前，先導出該環境變量：

export BRAVE_API_KEY=<your-key>

3. 啓用搜索提供者

該插件默認註冊 brave-search，但不會自動設爲默認提供者。需要在 cordis.patch.yml 中配置補丁：

- id: web
  config:
    searchProvider: brave-search

安裝腳本 bash install.sh 會自動處理上述配置。

典型用法¶

安裝並配置完成後，可以直接在命令行中使用 web_search 工具：

dsh --profile web "Use web_search to find one page about Node.js 24. Reply with just the URL."

注意事項¶

• 環境要求：需要 Node.js 版本 >= 18.17。
• 依賴關係：需要安裝對應的 @deepseek-ai/* peer 依賴（由宿主 DSH 提供）。
• 安全性：
  • API key 僅發送到配置的 baseURL（默認爲 Brave 官方端點）。
  • 自定義 baseURL 僅用於代理或測試，插件不驗證其域名。
  • 插件無 postinstall 腳本、無遙測、無其他網絡調用。

生態背景¶

DSH 採取插件化架構，本插件由社區維護，僅通過 npm 發佈，不涉及任何官方應用商店邏輯。更多細節與源碼可參考 GitHub 倉庫。