前言¶

DeepSeek Harness (DSH) 采用“一切皆插件”的理念。官方 Web 搜索每次触发都消耗一轮模型调用，且存在性能瓶颈。tavily-search 插件利用 Tavily API 接管模型的 web_search 工具，替换 DeepSeek 官方搜索。Tavily 更便宜、更快。

核心功能¶

1. 注册 tavily WebSearchProvider 替换官方搜索
2. 密钥经 credentials 服务实时解析，卸载后无残留
3. 提供设置页管理密钥、搜索行为（maxResults/searchDepth）与用量统计
4. 支持连接测试与同源校验路由
5. 按次计费（basic 1 credit/次，advanced 2 credits/次）
6. 服务端 60 秒缓存与 10 req/10min 限流处理

安装与启用¶

执行以下命令安装插件：

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

安装完成后重启 web 服务：

dsh web

配置与使用¶

1. 在设置页粘贴 Tavily API Key 并保存。
2. 使用连接测试框验证搜索功能。
3. 在 settings.yaml 的 dshp-inx-tavily-search 命名空间配置 maxResults 和 searchDepth：

dshp-inx-tavily-search:
  maxResults: 5
  searchDepth: basic

4. 若存在多个搜索提供方，需在 cordis.patch.yml 显式配置 searchProvider: tavily。

注意事项¶

• 密钥写入凭证库，不回显、不进模型上下文。
• 路由带同源校验，建议直接从浏览器访问 web 端口。
• 依赖 Node.js >= 20。