dsh-plugin-tavily

English | 中文

基于 Tavily 的 web 搜索提供方插件，用于 DeepSeek Harness (dsh)。

它把 tavily 搜索提供方注册进 harness 的 ctx.web seam，让内置的 web_search 工具通过 Tavily 联网搜索；同时提供一张 设置卡片（设置 → 插件 → 网页搜索），在图形界面里粘贴 API Key。一次安装，两个半部。

功能

• 即插即用的搜索后端：选中 tavily 后，内置 web_search 工具（以及 agent 自身的搜索）都由 Tavily 应答——面向模型的接口不变。
• GUI 设置卡片：在 设置 → 插件 → 网页搜索 编辑 API Key、默认结果数量与时效窗口；密钥经凭据服务写入，绝不进入配置文件。
• 其余设置走配置文件：接口地址、搜索深度、主题、生成式回答、凭据引用都在 cordis.patch.yml 中配置，卡片永远不会覆盖它们。
• 凭据优先的密钥解析：每次搜索按 字面量 apiKey → 凭据服务（apiKeyEnv）→ process.env[apiKeyEnv] 的顺序解析。

安装

dsh plugin --profile web add "github:1624318455/dsh-plugin-tavily#main"

开发期间可用本地路径安装：

dsh plugin --profile web add "file:/绝对路径/dsh-plugin-tavily"

插件只注册提供方和设置卡片，不会覆盖 profile 已选的搜索提供方。

启用

1. 选择提供方。二选一：设置环境变量

   export DSH_WEB_SEARCH_PROVIDER=tavily
   

   或在 profile 的 cordis.patch.yml（~/.dsh/profiles/web/cordis.patch.yml）中加一行：

   - id: web
     config:
       searchProvider: tavily
   

2. 设置 Tavily API key。打开 设置 → 插件 → 网页搜索，展开 网页搜索（Tavily） 卡片，把密钥粘贴进 API Key 输入框。卡片会显示是否已配置。没有密钥时提供方自报不可用，搜索会以 WEB_PROVIDER_CREDENTIAL_MISSING 明确失败，而不是静默返回空结果。

3. 重启 dsh，照常使用 web_search。面向模型的工具不变，只有背后的搜索后端换成 Tavily。

插件配置

GUI 卡片只编辑你最常改的三个值：API Key、默认结果数量（numResults）和时效窗口（days）。其余配置键一律写在 profile 配置里，卡片上不渲染：