dsh-tavily-search

DeepSeek Harness (DSH) 的 Tavily 网页搜索插件。

通过 Tavily Search API 直连提供 web-search-tavily 网页搜索工具，不消耗任何 LLM token——搜索费用只走 Tavily API 额度，Tavily 本身有免费额度。

特性

• 直接调用 api.tavily.com/search，无模型参与，搜索不烧 token
• 注册为 DSH web seam 的搜索 provider（id: tavily-official），工具名为 web-search-tavily
• 凭据通过 DSH 凭据服务或环境变量注入，API key 由你自己保管
• 标准 bundle 插件：一条命令装好并自动挂载，无需手改配置
• 纯 JS（ESM），无构建步骤

安装

需要 DSH 支持的环境（官方要求 Node.js 22.19+）。在 DSH profile 里执行：

dsh plugin --profile web add dsh-tavily-search

装完重启 dsh web 即可使用。dsh plugin 是 profile 目录里的 pnpm 转发层；若首次安装提示 ERR_PNPM_IGNORED_BUILDS，按提示在 profile 的 pnpm-workspace.yaml 的 allowBuilds 里加入相应依赖后重试。

配置

1. 填写 API key

在 Tavily 官网 注册获取自己的 API key，然后任选一种方式提供：

1. DSH 凭据服务（推荐）：把 TAVILY_API_KEY 存进 DSH 的凭据存储；
2. 环境变量：启动 dsh web 前导出 TAVILY_API_KEY；
3. 配置文件里直接写（不推荐，key 会落盘）：见下方覆盖配置中的 apiKey 字段。

2.（可选）覆盖默认配置

插件默认配置（apiKeyEnv: TAVILY_API_KEY、searchDepth: basic、includeAnswer: true）一般够用。需要调整时，在 profile 的 cordis.patch.yml 里按相同的行 id 覆盖：

# ~/.dsh/profiles/<name>/cordis.patch.yml
- id: web-search-tavily
  name: dsh-tavily-search
  config:
    apiKeyEnv: TAVILY_API_KEY   # 环境变量名，默认 TAVILY_API_KEY
    searchDepth: advanced       # basic | advanced，advanced 更贵更慢但更全
    includeAnswer: true         # 是否让 Tavily 生成自然语言回答

注意：按 id 覆盖时 config 是整段替换（不是深合并），要改的键都要写上。

3.（可选）把默认搜索切到 Tavily

想让搜索默认走 Tavily、并停用官方 DeepSeek 搜索（避免搜索消耗 LLM token），在 profile 的 cordis.patch.yml 追加：

- id: web
  name: '@deepseek-ai/dsh-web'
  config:
    searchProvider: tavily-official

- id: web-search-deepseek
  name: '@deepseek-ai/dsh-web-search-deepseek'
  disabled: true

4. 重启生效

dsh web

重启后对话里就能用 include:web-search-tavily 工具了。

配置项

字段	类型	默认值	说明
apiKey	string (secret)	—	直接写 key（不推荐，会落盘）
apiKeyEnv	string (credential-ref)	TAVILY_API_KEY	从凭据服务/环境读取 key 时用的名字
baseURL	string	https://api.tavily.com	Tavily API 地址，自建中转时可覆盖
searchDepth	string	basic	basic | advanced
includeAnswer	boolean	true	是否返回 Tavily 生成的自然语言回答

验证是否装好

dsh --profile web --dump-config   # 应出现 id: web-search-tavily 这一层

常见问题

Q: 搜索报 WEB_PROVIDER_CREDENTIAL_MISSING？ A: 没找到 key。确认 TAVILY_API_KEY 已通过凭据服务或环境变量提供，或检查 apiKeyEnv 拼写。

Q: 和官方 DeepSeek 搜索有什么区别？ A: 官方搜索走 DeepSeek 模型调用（每次搜索消耗 LLM token）；本插件直连 Tavily，只花 Tavily 额度。

Q: API key 会被共享吗？ A: 不会。key 只存在于你自己的 DSH 凭据存储/环境变量里，插件代码中没有任何 key，也不会上传任何 key。

License

MIT