前言¶
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
