nitrazepam01/dsh-web-search-tavily

用于DeepSeek Harness(dsh)的Tavily支持的网页搜索提供商捆绑包,支持热切换后端(Tavily / DeepSeek搜索)

Project Overview项目介绍

This is a native DSH bundle that adds Tavily web search support to DeepSeek Harness. It registers a custom Tavily backend for DSH’s built-in ctx.web search interface, and includes a hot-swappable backend selector to toggle between Tavily and the official DeepSeek web search provider. You can install it three different ways: from Git via dsh plugin --profile web add github:nitrazepam01/dsh-web-search-tavily, from npm via the same command with the package name, or from a local checked-out copy of the repository. After installation, you need to restart the dsh web process for the bundle to load.

After installation, you first configure your Tavily API key by adding it to the $DSH_HOME/.credentials.yaml file under the key TAVILY_API_KEY. Next, you set your active backend in the web-search section of $DSH_HOME/settings.yaml, and any change you save takes effect immediately without requiring a service restart or provider reload. You can also customize additional Tavily settings, including the base API endpoint, the name of the environment variable for your credential, and the maximum number of results returned per search query. This bundle is ideal for DSH users who prefer Tavily’s search result content excerpts, which let large language models directly quote information from search results.

This project is released under the permissive MIT open source license, so you can use, modify, and distribute it freely with no cost. It requires a valid Tavily API key to work, as all search queries are routed through Tavily’s official REST API endpoint by default. The bundle uses a delegating switcher provider to handle backend selection, which avoids the restart of the dsh-web plugin and disposal of existing providers that comes with direct edits to the web row configuration. This design choice makes backend switching much more convenient and keeps your DSH web instance stable during configuration changes.

这是为DeepSeek Harness(DSH)打造的原生Tavily网络搜索提供者包,为DSH的ctx.web网络搜索接口注册了Tavily后端,同时附带一个可热切换的后端选择器,支持用户在Tavily搜索和DeepSeek官方搜索之间切换。用户可以通过dsh插件命令从GitHub、npm或本地检出安装该包,安装后需要重启dsh web服务生效。

安装后用户需要先配置Tavily API密钥,可通过DSH_HOME目录下的credentials.yaml文件存储密钥,之后在settings.yaml的web-search区块选择要激活的后端,修改保存后设置立即生效,无需重启服务或重载模块。该项目适合需要使用Tavily高质量摘要搜索结果的DSH用户,可满足模型直接引用搜索片段的需求。

该项目使用MIT许可证开源,无额外使用成本,依赖用户拥有可用的Tavily API密钥,支持自定义Tavily API端点、单搜索最大结果数等配置。它使用委托提供者实现热切换,避免了直接修改web行配置导致的dsh-web插件重启和已有提供者销毁问题,使用更稳定。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 nitrazepam01/dsh-web-search-tavily 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-web-search-tavily

A Tavily-backed search provider bundle for DeepSeek Harness (dsh). It registers a Tavily backend for the ctx.web web-search seam and ships a hot-switchable backend selector (Tavily / DeepSeek search).

Features

  • Tavily provider — calls POST /search and normalizes results to { url, title, snippet, publishedAt }. Tavily returns content excerpts, so the model can quote snippets directly.
  • Hot backend switcher — a delegating provider (search-switch) sits behind the web row and resolves the active backend from the web-search settings section on every search. Saving the section takes effect immediately: no restart, no loader-row reload.
  • Full WebError taxonomy (WEB_PROVIDER_ERROR / WEB_PROVIDER_CREDENTIAL_MISSING / WEB_ABORTED).
  • Credential resolution chain: literal apiKey → credentials service → launch environment.
  • Settings sections:
    • web-search-tavily — apiKey / apiKeyEnv / baseURL / maxResults
    • web-search — backend selection (tavily | deepseek-official)

Install

# From git (recommended — plain JS, no build step, no allowBuilds required)
dsh plugin --profile web add github:nitrazepam01/dsh-web-search-tavily

# From npm
dsh plugin --profile web add dsh-web-search-tavily

# From a local checkout
dsh plugin --profile web add ./dsh-web-search-tavily

Restart dsh web after installing (bundle layers are frozen at boot). To uninstall: dsh plugin --profile web remove dsh-web-search-tavily.

Configuration

1. Credential

Store your Tavily key in $DSH_HOME/.credentials.yaml:

TAVILY_API_KEY: tvly-your-key

2. Backend selection

The web row's searchProvider is set to search-switch (the delegating provider) by this bundle. The active backend lives in the web-search section of $DSH_HOME/settings.yaml and hot-reloads on save:

web-search:
  backend: tavily            # tavily | deepseek-official
  • tavily — this plugin's Tavily provider (results carry content excerpts)
  • deepseek-official — delegates to the shipped web-search-deepseek provider (DeepSeek Anthropic-compatible Messages endpoint; no excerpts)

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-skin-switcher 下一个 Next dsh-3d-plugin-graph →