← 返回列表
未验证
给 DeepSeek Harness 的 Tavily 版 websearch / webfetch 后端：把内置的…
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/9/13 · 已提供中文文档
为 DeepSeek Harness 提供由 Tavily 支持的 web_search / web_fetch 提供程序——替代内置的 DeepSeek 搜索后端（兼容 0.1.1-rc.x 和 0.1.5）
综合分
28.8
GitHub 分
28.8
用户评分
—
★ Stars
0
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add MirrMeur/dsh-tavily-provider该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
信任档位：已验证本站已于 0 天前真实安装成功（L4 · 真实安装）
- 是什么
- dsh 原生插件 · tool
- 装得上吗
- 本站已真实安装成功（L4 · 真实安装，非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 13 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/25
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/24（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成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: # 一般不填：明文落盘，优先级最高
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_search | tavily | POST /search；把 results[] 映射成 {url, title, snippet, publishedAt} |
| web_fetch | tavily-extract | POST /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