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 仓库 或 社区目录。