前言¶

在 DSH 里，网页搜索默认使用官方 DeepSeek。若希望切换到 Tavily，常见做法是调整搜索来源或重装插件，切换成本较高。dsh-tavily 将 Tavily 作为 DSH 的网页搜索服务提供商，并提供设置卡开关：关闭时继续使用官方 DeepSeek，打开时改用 Tavily，不需要反复卸载安装包。

截至 2026-08-30，建议将插件更新到 0.3.1。下面介绍功能、安装命令、启用方式和需要注意的问题。

这是什么¶

dsh-tavily 是 DeepSeek Harness（DSH）的 Tavily 网页搜索插件。它面向 DSH 的 Web 客户端，提供可选的 Tavily 网页搜索：开关关闭时使用官方 DeepSeek；开关打开后，根据是否填写 Key 分别走 keyless 或账号档。

仓库 owner 为 SZMY-haruhi，许可证为 MIT。

核心功能¶

• 设置卡开关：关 = 官方 DeepSeek，开 = Tavily，切换时不用卸包。
• 无 Key 时走 Tavily keyless；有 Key 时走 Authorization: Bearer。
• 设置卡左下有连通测试：真实调用一次 Tavily，请求参数为 max_results: 1；无 Key 走 keyless，有 Key 走账号档，并消耗 1 积分。
• 处理超时、中止、官方 Host 锁定，并丢掉无 url 的结果。
• Key / 开关写在 credentials，不写设置文件。
• 设置卡命名空间为 web-search-tavily，不覆盖官方网页搜索卡。

安装与启用¶

先用 npm 安装稳定版：

dsh plugin --profile web add dsh-tavily

如果已经安装旧版本，先更新到 0.3.1：

dsh plugin --profile web update dsh-tavily

也可以用 GitHub 仓库安装：

dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily

如果需要固定版本，可以钉 commit 安装：

dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily#<commit>

安装完成后，按下面路径进入插件配置：

设置 → 插件 → 插件配置 → Tavily 网页搜索

打开“Tavily 网页搜索”开关即可启用。Key 可选；不填 Key 时走 Tavily keyless。左下的连通测试用来确认现在能不能搜。有 Key 时，连通测试会消耗 1 积分。

如需卸载：

dsh plugin --profile web remove dsh-tavily

典型用法¶

按下面顺序操作即可。

1、安装插件：

dsh plugin --profile web add dsh-tavily

2、进入设置：

设置 → 插件 → 插件配置 → Tavily 网页搜索

3、打开开关。开启后，网页搜索从官方 DeepSeek 切换到 Tavily。

4、保持 Key 为空，或填入 Tavily Key。不填时走 keyless；填写后走账号档。

5、点击左下连通测试。无 Key 时也能测试；有 Key 时用于确认账号档当前是否能用。

6、经过上面的步骤后，如版本较旧，执行更新：

dsh plugin --profile web update dsh-tavily

凭证位置¶

Key / 开关不写在设置文件里，而是写在 credentials 中。凭证可写在：

$DSH_HOME/.credentials.yaml

不要把真实钥匙提交进仓库。

版本与兼容注意¶

• 请更新到 0.3.1。
• 0.3.0 在和其它客户端插件一起安装时，可能让整个 Web 停在 “Failed to load plugins”。
• 0.3.1 修复了 settings.plugin.item 需 key，不能再用 id 或 order 的问题。
• 0.3.1 的设置卡命名空间为 web-search-tavily，不覆盖官方网页搜索卡。

适用场景与注意¶

适合以下使用方式：

• 想在 DSH 的 Web 客户端中使用 Tavily 网页搜索。
• 希望在官方 DeepSeek 与 Tavily 之间用开关切换，不反复安装和卸载。
• 想先不填 Key，用 keyless 模式确认连通性。

安装前建议检查源码与许可证。dsh-tavily 会作为 DSH Web 客户端的插件运行，插件代码会随当前 dsh 进程权限执行；引入前请确认其实现符合项目要求。许可证为 MIT。

链接¶

• 目录页：https://www.skillhub.cn/plugins/SZMY-haruhi/dsh-tavily
• GitHub：https://github.com/SZMY-haruhi/dsh-tavily