前言¶
在 DeepSeek Harness（DSH）里做智能体时，网页搜索是常见能力。DSH 的 web capability seam 暴露 ctx.web，内置 web_search 工具默认走 shipped DeepSeek route。如果你希望同一套 web_search 工具改走 Tavily，并且不想一开始就强制配置 API key，可以看一下 dsh-web-search-tavily。
这是什么¶
dsh-web-search-tavily 是 cnChenKai 维护的 DSH 插件，许可证为 MIT。
它给 DeepSeek Harness 的 web seam（ctx.web）提供一个 Tavily-backed WebSearchProvider，让内置 web_search 工具在运行时调用 Tavily 的 search API，而不是默认的 DeepSeek route。
核心能力¶
- Keyless mode：没有配置 API key 时，插件会发送官方 header
X-Tavily-Access-Mode: keyless，可以直接使用，不需要TAVILY_API_KEY。 - Keyed upgrade：如果设置
TAVILY_API_KEY，插件会切换到 keyed 模式；key 可以从环境变量或~/.dsh/.credentials.yaml读取，并且每次搜索都会重新解析。 - 官方默认参数：
search_depth: basic（1 credit）、include_answer: false、max_results: 5、chunks_per_source: 3。 - 替换默认搜索路由：插件让内置
web_search工具走 Tavily search API，而不是 DSH 自带的 DeepSeek route。
安装与启用¶
插件要求 Node >= 22。
先安装插件：
dsh plugin --profile web add dsh-web-search-tavily
安装后，如果不想配置 API key，可以直接使用 keyless mode。
如果要使用 keyed 模式，在 ~/.dsh/.credentials.yaml 中配置：
# ~/.dsh/.credentials.yaml
TAVILY_API_KEY: tvly-...
这里的 key 会在每次搜索时重新解析。
插件的 bundle patch 会自动设置 provider。如果你希望手动切换，也可以在自己的 cordis.patch.yml 中设置：
# cordis.patch.yml
- id: web
name: '@deepseek-ai/dsh-web'
config:
searchProvider: tavily
典型用法¶
下面的步骤可以先跑通最小路径：
- 确认环境是
Node >= 22。 - 执行安装命令：
dsh plugin --profile web add dsh-web-search-tavily
- 不设置
TAVILY_API_KEY时，web_search会走 Tavily 的 keyless mode。 - 如果需要更高配额，把
TAVILY_API_KEY写入~/.dsh/.credentials.yaml或环境变量。 - 如果插件没有自动选中 provider，在
cordis.patch.yml中手动设置searchProvider: tavily。
默认请求参数为：
search_depth: basic
include_answer: false
max_results: 5
chunks_per_source: 3
适用场景与注意¶
适合以下情况：
- 你正在使用 DSH，并需要让内置
web_search走 Tavily。 - 你希望先无 key 试用，再按需切换到 keyed 模式。
- 你的运行环境满足
Node >= 22。
注意：
- 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
- 该插件属于 DSH 社区插件，不应写成 DeepSeek / 幻方官方应用商店应用。
- Keyed 模式可参考 Tavily 提供的免费额度：
app.tavily.com提供 1,000 free credits/month。
结尾¶
dsh-web-search-tavily 的价值在于给 DSH 的 web_search 提供一个可选的 Tavily 后端：无 key 时可以直接跑，有 key 时可以继续提升配额与使用层级。
GitHub：
https://github.com/cnChenKai/dsh-web-search-tavily
目录页可在 DSH 社区目录中按 dsh-web-search-tavily 搜索。
