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