dsh-web-search-tavily: 基於 Tavily 的 DeepSeek Harness 聯網搜索插件

前言¶

在 DeepSeek Harness (DSH) 的開發中，默認的聯網搜索功能通常需要調用輔助模型，消耗模型 token 且耗時較長。爲了優化這一過程，社區提供了基於 Tavily Search API 的替代方案。這個插件通過直接調用 Tavily REST 接口，降低了搜索延遲和成本。

這是什麼¶

這是一個爲 DeepSeek Harness (dsh) 提供聯網搜索能力的插件。它通過註冊 WebSearchProvider（id: ‘tavily’）來替換默認的 web_search 插件。插件維護者爲 fan56，基於 MIT 許可證開源。

核心功能¶

• 提供基於 Tavily Search API 的聯網搜索功能。
• 替換 DeepSeek 默認的 web_search 插件，不再依賴模型輔助調用，僅消耗少量積分。
• 支持配置搜索深度、主題、最大結果數等參數。
• 支持通過環境變量或配置文件注入 API Key，API Key 存儲在宿主機管理的憑據文檔中，不寫入配置文件。
• 註冊 WebSearchProvider (id: ‘tavily’)。

安裝與啓用¶

1. 確保已安裝 DeepSeek Harness 且版本滿足 >= 0.2.0-rc.2。
2. 執行安裝命令：

dsh plugin --profile <name> add @aiwayds/dsh-web-search-tavily

安裝完成後重啓 dsh，插件即被註冊。

典型用法¶

• 配置 API Key：在 ~/.dsh/.credentials.yaml 中添加：

version: 1
refs:
  TAVILY_API_KEY: tvly-xxxxxxxx

• 配置搜索提供者：在 cordis.patch.yml 中設置：

- id: web
  config:
    searchProvider: tavily

• 卸載：如需移除，執行：

dsh plugin --profile <name> remove @aiwayds/dsh-web-search-tavily

適用場景與注意¶

• 該插件以當前 dsh 進程的權限運行，安裝前建議檢查源碼。
• 需要擁有有效的 Tavily API Key。
• 安裝時不會自動聲稱 web_search 默認，需要在配置文件中手動切換。
• 許可證爲 MIT。

結語¶

該插件通過引入 Tavily API，簡化了 DSH 中的聯網搜索流程。更多細節可查閱 GitHub 倉庫 或 社區目錄。