DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-tavily-provider

M

dsh-tavily-provider

Manifest valid

Tavily-backed web_search / web_fetch providers for DeepSeek Harness — replaces the built-in DeepSeek search backend (0.1.1-rc.x and 0.1.5 compatible)

hasBundlePatch

dsh-tavily-provider

给 DeepSeek Harness 的 Tavily 版 web_search / web_fetch 后端:把内置的 DeepSeek 搜索换成 Tavily, 用你已有的 TAVILY_API_KEY(存在凭证里)作答。

零依赖、零 import:整个插件不 import 任何 @deepseek-ai/*,只用宿主注入的 ctx 和全局 fetch。 因此它同时适用于 0.1.1-rc.x 和 0.1.5 线,也不会因为客户端/设置 API 改名而失效 (0.1.5 删掉了 @deepseek-ai/dsh-client-runtime,并从 dsh-settings 移除了 installSettingsSection / settingsNamespace —— 本插件两者都不碰)。

为什么需要它

社区插件 @dsh-external/dsh-plugin-tavily@0.6.2 在 0.1.5 上会让整个 profile 起不来:

dsh-plugin-tavily@0.6.2 → "@deepseek-ai/dsh-settings" 不再导出 installSettingsSection / settingsNamespace
dsh: plugin tree failed to load → exit 1

上游没有 0.1.5 适配版(作者 CI 矩阵封顶 0.1.1-rc.2)。本插件沿用完全相同的 provider id, 所以升级后 profile 里那两行配置原样即可:

- id: web
  config:
    searchProvider: tavily
    fetchProvider: tavily-extract

安装

# 从 GitHub 直接装(推荐)
dsh plugin --profile web add github:MirrMeur/dsh-tavily-provider

# 钉住某个 tag / commit(更可复现)
dsh plugin --profile web add github:MirrMeur/dsh-tavily-provider#v0.1.0

# 本地目录开发用(link 挂载,改文件后重启即生效)
dsh plugin --profile web add file:/path/to/dsh-tavily-provider

装完重启该 profile 的 Harness 进程(不是刷新浏览器),再确认 cordis.patch.yml 里有上面那两行。

更新

git 依赖在 spec 不变时 pnpm 可能报 Already up to date 而不刷新,强制重解析一次:

cd ~/.dsh/profiles/web          # 或 $DSH_HOME/profiles/web
pnpm up dsh-tavily-provider

或改钉 tag 重装:

dsh plugin --profile web add github:MirrMeur/dsh-tavily-provider#v0.2.0

配置

全部可选,写在 profile 的 cordis.patch.yml 里,按 entry id 定位:

- id: tavily-provider
  config:
    maxResults: 5          # 1..20,web_search 未显式传 maxResults 时的默认值
    searchDepth: basic     # basic | advanced
    topic: general         # general | news
    apiKeyEnv: TAVILY_API_KEY   # 凭证名;默认就是它
    apiKey: <literal>      # 一般不填:明文落盘,优先级最高
    baseURL: https://api.tavily.com

API key 解析顺序:apiKey 字面量 → 凭证服务 ctx.get("credentials").resolve(apiKeyEnv) (即 ~/.dsh/.credentials.yaml 里的 TAVILY_API_KEY)→ 进程环境变量 TAVILY_API_KEY。 都没有时走 Tavily keyless(匿名限额,够轻量用)。

行为

能力provider id说明
web_searchtavilyPOST /search;把 results[] 映射成 {url, title, snippet, publishedAt}
web_fetchtavily-extractPOST /extract(markdown),映射成 {url, statusCode, body:{kind:"text",content}}

失败语义跟随宿主 seam:网络/超时 → WEB_PROVIDER_ERROR(消息里带 HTTP 状态与凭证名提示), 调用方取消 → WEB_ABORTED。

自查

node test/smoke.mjs     # 10 项:映射、clamp、keyless、凭证/环境回退、401、abort、注册

真实接口冒烟(会消耗一次 Tavily 配额):

TAVILY_API_KEY=... node -e '
import("./lib/index.js").then(async (m) => {
  const key = process.env.TAVILY_API_KEY;
  const ctx = { get: (s) => s === "credentials" ? { resolve: async () => ({ value: key }) } : undefined };
  const p = new m.TavilySearchProvider(() => ({ ctx, config: { maxResults: 3 } }));
  console.log(await p.search({ query: "DeepSeek Harness" }));
});'

已验证

  • 10 项单测(stub fetch)
  • 真实 Tavily API:/search 返回 3 条(含标题/URL/snippet),/extract 返回 19k 字符正文
  • 隔离宿主 DeepSeek Harness 0.1.5-rc.2:profile 启动正常,headless 下 web_search 实际由本 provider 作答

局限

  • 没有设置卡片(设置页 UI)。配置走 cordis.patch.yml;旧插件的卡片在 0.1.5 上本来就不可用。
  • web_fetch 只支持文本/markdown,不做图片、PDF 解析。
  • 未实现 firecrawl(旧插件里的第三后端,实际未启用)。

License

MIT

Comments

Loading…

Similar plugins

dsh-web-search-tavily

by nitrazepam01

Tavily-backed web search provider bundle for DeepSeek Harness (dsh) with hot-switchable backend (Tavily / DeepSeek search)

Manifest valid

★ 3

↓ 179/wk

MIT

JavaScript

Aug 14, 2026

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

by renchengxiang

Tavily-backed search provider for native web_search, with a Settings → Plugins card for API key management and toggling DeepSeek replacement.

Tools & CapabilitiesManifest valid

★ 2

↓ 209/wk

MIT

JavaScript

Sep 22, 2026

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

by paul-yangmy

Tavily-backed web search provider plugin (bundle) for DeepSeek Harness (dsh)

Manifest valid

★ 0

MIT

JavaScript

Aug 17, 2026

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

by 1624318455

Tavily-backed web search provider for the built-in web_search tool, with a settings card for the API key, result count, and recency window.

Tools & CapabilitiesManifest valid

★ 6

MIT

TypeScript

Sep 12, 2026

dsh plugin --profile web add @dsh-external/dsh-plugin-tavily

by VviLliAm-qwq

Tavily-backed search provider for dsh: registers the tavily provider on the ctx.web seam so the web_search tool runs against the Tavily Search API

Manifest valid

★ 0

MIT

JavaScript

Sep 16, 2026

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

by zx06

Tavily web search plugin for DeepSeek Harness (DSH): ctx.web search provider + search/extract/crawl/map/research tools + settings page (API key, quota, audit)

Manifest valid

★ 0

MIT

TypeScript

Nov 16, 2026

dsh plugin --profile web add @zx06/tavily