前言¶

DeepSeek Harness (DSH) 目前處於預覽階段，其“一切皆插件”的架構允許開發者根據需求擴展功能。在進行智能體開發或日常使用時，網頁搜索往往是一個核心功能。然而，使用單一 API 密鑰容易遇到速率限制或額度耗盡的問題。爲了解決單密鑰帶來的瓶頸，下面介紹一個多密鑰管理插件，它通過 Tavily 的接口接管 DSH 的搜索與抓取能力。

是什麼¶

dsh-tavily-pool 是由 stormbuf 維護的一個聯網工具類插件。它爲 DeepSeek Harness 提供了基於 Tavily 的網頁搜索和頁面抓取能力。該插件的核心價值在於管理一個密鑰池，通過餘額感知的輪轉策略和自動故障轉移機制，確保搜索請求的連續性和穩定性。

核心功能¶

插件實現了以下具體功能：

1. 多密鑰池管理
   支持批量粘貼 API 密鑰（每行一個）。在設置面板中，可以對密鑰進行標籤、啓用/禁用、排序和批量刪除操作。界面始終顯示掩碼後的密鑰，僅通過設置面板輸入，不讀取環境變量或憑據服務。

2. 餘額感知輪轉
   插件優先使用餘額最高的密鑰。它支持無限密鑰檢測（當 key.limit 和 account.plan_limit 均爲 null 時）。插件會定期通過官方 /usage 接口刷新余額數據，不維護本地記賬，以避免因計費規則變更導致的誤差。

3. 自動故障轉移與冷卻機制
   當某個密鑰請求失敗時，插件會自動切換到下一個可用密鑰。同時，它尊重上游返回的 Retry-After 頭部，對冷卻中的密鑰進行硬性排除，防止過載。

4. 功能接管與配置

   • 搜索接管：接管 web_search 接口，可配置深度、結果上限、主題和生成答案開關。
   • 抓取接管：默認關閉，開啓後將 web_fetch 映射到 Tavily 的 /extract 接口，返回純文本而非 HTML。
   • 獨立開關：搜索和抓取功能可以分別獨立切換回官方提供者。

5. 調用監控
   記錄每次調用的詳細信息（密鑰、端點、結果、耗時、request_id），並提供 14 天的調用計數圖表。數據文件受條目數和 30 天窗口限制。

6. 技術特性
   純 ESM 實現，零運行時依賴，無需構建步驟。

安裝與啓用¶

安裝該插件需要 DeepSeek Harness 環境。

1、執行以下命令安裝插件：

dsh plugin add dsh-tavily-pool

或者從 GitHub 安裝（無需註冊 npm 賬戶）：

dsh plugin add github:stormbuf/dsh-tavily-pool

若需安裝特定版本，請使用：

dsh plugin add github:stormbuf/dsh-tavily-pool#vX.Y.Z

2、安裝完成後，重啓 DSH。

3、進入 設置 → 插件 → dsh-tavily-pool，在設置面板中粘貼您的 Tavily API 密鑰。

典型用法¶

啓用插件後，搜索和抓取功能默認已接管。您可以通過設置面板調整搜索參數（如搜索深度、結果上限）。

• 切換提供者：如果您希望回退到官方搜索或抓取提供者，可以在設置面板中分別關閉對應的開關。
• 密鑰管理：在密鑰列表中，您可以隨時添加新密鑰、調整排序順序（餘額優先或手動順序）或移除不再使用的密鑰。

適用場景與注意¶

• 適用場景：需要高可用性網頁搜索、擁有多個 Tavily API 密鑰、需要通過抓取獲取頁面純文本內容的開發者。
• 注意：由於 DeepSeek Harness 處於預覽階段，插件通過適配層隔離宿主特定知識。安裝前建議查看源碼並確認許可證（MIT）符合項目要求。插件僅通過 DSH 設置面板接受密鑰輸入，不依賴環境變量。

結語¶

該插件通過集中管理密鑰池和智能調度策略，解決了單密鑰搜索的穩定性問題。其零依賴和獨立的配置面板也降低了集成難度。更多技術細節可參考其 GitHub 倉庫。