dsh-web-search-tavily：Tavily 網頁搜索插件

前言¶

DeepSeek Harness (DSH) 採用了“一切皆插件”的架構理念。在構建智能體或調試工具時，聯網搜索是常見需求。雖然 DSH 原生提供了 web_search 後端，但有時開發者希望使用更專業的搜索引擎接口。dsh-web-search-tavily 插件旨在通過集成 Tavily 搜索 API，爲 DSH 提供更專業的網頁檢索能力。

插件簡介¶

這是一個基於 Tavily 的網頁搜索提供者，由開發者 renchengxiang 維護。它主要解決的問題是：在不修改原生代碼的情況下，將 DSH 的 web_search 後端切換爲 Tavily，並提供了可視化的 API Key 管理界面。

核心功能¶

該插件提供以下能力：

Provider 註冊：在 ctx.web 上下文中註冊 tavily provider。
後端替換：支持將 DeepSeek 原生的 web_search 後端替換爲 Tavily。
配置管理：在 Settings → Plugins 下添加插件配置卡片，用於管理 Tavily API Key。
UI 集成：在 tavily-search 命名空間下添加插件卡片。
持久化：通過 profile bundle patch 機制，插件配置在重啓後依然有效。

安裝與啓用¶

使用官方安裝命令添加插件：

dsh plugin --profile web add github:renchengxiang/dsh-web-search-tavily

安裝完成後，必須完全重啓 DeepSeek Harness Desktop 或 dsh web 進程，插件纔會生效。

配置方法¶

打開 Settings → Plugins → Plugin configuration。
展開 Tavily search 卡片。
輸入你的 Tavily API Key。
如果希望 web_search 功能直接使用 Tavily，保持 Replace native web search 選項開啓。
保存配置。

除了在界面上配置，你也可以通過導出環境變量或憑證名爲 TAVILY_API_KEY 的方式提供密鑰。

技術細節與注意事項¶

Bundle Patch：該插件通過 dsh.bundle.patch 掛載 cordis.patch.yml 文件。對於標準安裝，無需手動編輯 cordis.patch.yml。
避免衝突：如果你之前手動掛載過本地開發副本，請在安裝前移除舊的本地掛載行，以防止發生雙重註冊。

適用場景¶

適合需要使用 Tavily 搜索 API 進行聯網檢索的開發者。插件以當前 DSH 進程的權限運行。

DSH 生態強調插件化，社區目錄（如 SkillHub）提供了插件索引，但這與 DeepSeek 官方或幻方團隊無官方從屬關係。使用前請自行檢查源碼與許可證（MIT）。

配置完成後，web_search 的後端將由 Tavily 接管。項目地址：https://github.com/renchengxiang/dsh-web-search-tavily