前言¶
DeepSeek Harness (DSH) 的插件化架構允許開發者通過 seam（接口）擴展系統的核心能力。對於需要聯網能力的場景，直接對接外部搜索 API 是常見需求。該插件通過註冊 Web Search Provider，將 DSH 的 web-search seam 路由到 Tavily API，並提供可視化的配置入口，避免了手動編寫 Provider 代碼的複雜度。
這是什麼¶
該插件由 libinghui55 維護，是一個基於 Tavily 的 Web 搜索 Provider。它將 DSH 的 web-search seam 接口對接到 Tavily API，並在設置界面生成一個名爲 tavily-search 的配置卡片，支持開關和 API Key 管理。
核心功能¶
- Provider 註冊：註冊了一個 ID 爲
tavily的 Web Search Provider，並接管 harness 的 web seam。 - GUI 配置卡片：在
設置 -> 插件中提供名爲tavily-search的配置界面。 - 開關控制：提供 on/off 開關，關閉後 Provider 報告自己不可用並拒絕搜索。
- 安全存儲：API Key 通過 Harness Credentials Service 存儲，不寫入設置文件，也不會回顯給客戶端。
- 多級解析：支持從 Literal Config、Environment Variable 或 Credentials File 中解析 API Key。
- 端點配置：支持通過
baseURL配置 Tavily 的 API 端點（默認爲 https://api.tavily.com）。
安裝與啓用¶
該插件是 npm 包，通過 DSH 的 profile bundle 機制進行安裝。
- 確保目標 profile 已包含 web search seam（例如默認的
webprofile）。 - 執行安裝命令：
dsh plugin --profile web add <path-to-dsh-tavily-search>
典型用法¶
安裝完成後，Provider 即可被 harness 調用。
- GUI 配置：進入
設置 -> 插件，展開tavily-search，在 API Key 字段輸入密鑰並保存。 - YAML 配置：通過配置文件控制狀態，例如禁用插件：
web-search-tavily:
enabled: false
- API Key 配置：API Key 的解析優先級如下：
- Literal
apiKey字段。 - Credentials Service（默認引用名爲
TAVILY_API_KEY的憑證）。 - 進程環境變量
TAVILY_API_KEY。
- Literal
適用場景與注意¶
- 適用場景：適合需要在 DeepSeek Harness 中快速集成 Tavily 搜索能力，並希望利用 GUI 進行簡單配置的開發者。
- 環境變量衝突：如果進程環境中已存在
TAVILY_API_KEY，Credentials Service 會報告該 Key 爲繼承狀態。此時 GUI 卡片中的 Key 輸入框會被禁用（只讀），無法在 UI 中修改。如需通過 UI 修改，請將 Key 存儲在憑證文件中。 - 權限安全：插件以當前 DSH 進程的權限運行，使用前請檢查源碼與許可證。
結尾¶
該插件通過 GUI 和插件化機制，簡化了在 DeepSeek Harness 中接入 Tavily 搜索的流程。
- 目錄頁：https://www.skillhub.cn/plugins/libinghui55/dsh-tavily-search
- 源碼地址：https://github.com/libinghui55/dsh-tavily-search
