前言¶

DeepSeek Harness (DSH) 的內置 web_search 工具通常依賴單一提供商，一旦該服務出現速率限制或故障，搜索便無法進行。websearch-dsh 插件通過替換該後端，提供了一個具有韌性的多提供商回退鏈，並支持在沒有 DeepSeek API 密鑰的情況下通過無密鑰的 DuckDuckGo 繼續工作。

插件概述¶

該插件由 takasurazeem 維護，採用 MIT 許可證。它註冊在 DSH 的 ctx.web 接口上，保持了 web_search 工具的接口不變，但通過鏈提供結果。

核心能力¶

1. 替換內置單一提供商 web_search 爲具有韌性的多提供商回退鏈。
2. 支持在沒有 DEEPSEEK_API_KEY 的情況下工作，使用無密鑰的 DuckDuckGo。
3. 容錯：可存活於提供商速率限制、配額耗盡和停機情況。
4. 通過 GUI 開關啓用/禁用（設置 -> 插件 -> 可配置 -> 網絡搜索）。
5. 無需重啓即可更新密鑰和開關。
6. 提供 websearch_status 工具和 /websearch status 命令。
7. 通過環境變量或 DSH 憑據屏幕支持 API 密鑰。

安裝與啓用¶

在您的個人資料 package.json 中添加依賴項，並將插件包添加到 dsh.bundles 列表中。然後在配置目錄中運行 pnpm install，最後重啓 DSH。

示例 package.json 配置：

{
  "name": "my-profile",
  "dependencies": {
    "websearch-dsh": "file:/path/to/websearch-dsh"
  },
  "dsh": {
    "bundles": [
      "@deepseek-ai/dsh-base",
      "@deepseek-ai/dsh-web-app",
      "websearch-dsh"
    ]
  }
}

啓用：
在 DSH 網頁客戶端中，導航至 設置 -> 插件 -> 可配置 -> 網絡搜索。點擊開關以啓用。

配置 API 密鑰¶

密鑰可以存儲在環境變量或 DSH 憑據屏幕中。
- 環境變量：~/.dsh/.env（推薦 chmod 600）。
- DSH 憑據屏幕。

可用密鑰變量：
- TAVILY_API_KEY
- EXA_API_KEY
- FIRECRAWL_API_KEY
- BRAVE_API_KEY
- SERPER_API_KEY

工作原理¶

當調用 web_search 時，系統會按順序檢查提供商：
1. Tavily
2. Exa
3. Firecrawl
4. Brave
5. Serper
6. DuckDuckGo（總是最後，無需密鑰）

密鑰在每次搜索時解析，因此添加密鑰無需重啓。

注意事項¶

• MIT 許可證。
• 無 MCP 服務器，無 sidecar 進程。
• maxResults 限制爲 1-50。

使用方式¶

• 正常使用 web_search 工具。
• 運行 /websearch status 以檢查提供商狀態。