SZMY-haruhi/dsh-tavily 预览 preview

SZMY-haruhi/dsh-tavily

为DSH新增Tavily搜索API,作为其网页搜索服务提供商。

Project Overview项目介绍

This is a native DSH plugin built exclusively for DeepSeek Harness that adds Tavily as an alternative web search provider for the agent. It ships with pre-built bundled code, so installing directly from GitHub does not require enabling the allowBuilds permission in DSH. Users install it via DSH's built-in command line plugin manager, with options to install the stable release from the npm registry, pull the latest commit from GitHub, or pin the installation to a specific commit hash for consistency.

After installation, users can access the plugin's configuration card directly in DSH's settings panel. A simple toggle switch lets users enable or disable Tavily search without uninstalling the plugin itself. You can use Tavily's free keyless search without any API key, or add your own Tavily API key to use your account's allocated search quota. The settings panel also includes a connectivity test that verifies the search service is working, even for keyless usage.

The plugin is released under the permissive MIT open-source license, so it is free to use and modify for any purpose. Versions older than 0.3.1 have a known compatibility issue that can break DSH's plugin loading system when other client plugins are installed, so all users must update to the latest fixed version. API keys and the enabled toggle are stored in DSH's dedicated credentials file, not in plaintext settings or committed to public repositories.

这是专为 DeepSeek Harness 开发的原生网页搜索插件,为 DSH 提供 Tavily 作为可替代的网页搜索服务提供商。它自带预构建产物,通过 Git 安装无需开启允许构建权限。用户可以通过 DSH 的官方插件命令行工具安装,既可以从 npm 官方源安装稳定版,也可以直接从 GitHub 仓库拉取最新提交,还支持固定到指定 commit 版本。

安装完成后,用户可以在 DSH 的设置面板找到 Tavily 网页搜索的配置项,通过开关切换是否启用 Tavily 搜索,无需卸载插件。支持无 API Key 的免费匿名搜索,也支持填入个人 Tavily API Key 使用自有账号额度。配置面板左下角自带连通测试功能,开启后可直接验证当前搜索服务是否连通可用。

该插件使用 MIT 开源许可证,无任何使用成本。需要注意的是,0.3.0 及更早版本存在兼容问题,和其他客户端插件同时安装时可能导致 DSH Web 界面加载失败,因此必须更新到 0.3.1 及以上版本。API Key 存储在 DSH 的凭证文件中,不会保存在普通设置文件里,也不会上传到公共仓库。

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-tavily

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

READMEREADME

dsh-tavily

中文 | English

awesome · DSH plugin 推荐 dshfind

DeepSeek Harness 的 Tavily 网页搜索。作为其网页搜索服务提供商。

安装

npm(稳定版,官方推荐):

dsh plugin --profile web add dsh-tavily

也可以跟 GitHub(跟仓库最新提交):

dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily

设置 → 插件 → 插件配置 → Tavily 网页搜索:打开开关即可。Key 可选,不填走无 Key。左下「连通测试」可确认现在能不能搜(无 Key 也测得通)。

请更新到 0.3.1。 0.3.0 在和其它客户端插件一起装时,可能让整个 Web 停在「Failed to load plugins」(设置卡按 list 槽注册,当前 DSH 要求 keyed key)。已修复。npm:

dsh plugin --profile web update dsh-tavily

GitHub 安装则再执行一次 add github:SZMY-haruhi/dsh-tavily。

Tavily 网页搜索设置:无 Key 时连通测试通过

钉 commit:

dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily#<commit>

卸载:

dsh plugin --profile web remove dsh-tavily

dsh.bundle · 预构建 lib/ · git 安装无需 allowBuilds

特点

  • 设置卡开关:关 = 官方 DeepSeek,开 = Tavily,不用卸包
  • 无 Key 走 Tavily keyless;有 Key 走 Authorization: Bearer
  • 左下连通测试:真打一次 Tavily(max_results: 1);无 Key 走 keyless,有 Key 走账号档(消耗 1 积分)
  • 超时、中止、官方 Host 锁定、丢掉无 url 的结果
  • Key / 开关写在 credentials,不写设置文件

行为

开关 Key web_search
关(默认) — 官方 DeepSeek
开 未填 Tavily keyless
开 已填 Tavily 账号档

Provider id:tavily。

凭证

引用 含义
TAVILY_API_KEY 可选。有则走账号档;无则 keyless
TAVILY_SEARCH_ENABLED 有此项则为开;删除即关

可写在 $DSH_HOME/.credentials.yaml。不要把真实钥匙提交进仓库。

更新

  • 2026-08-17 0.3.1(请更新) 修复:与其它客户端插件同时安装时,Web 可能卡在「Failed to load plugins / dsh-tavily」(settings.plugin.item 需 key,不能再用 id/order)。设置卡命名空间 web-search-tavily,不覆盖官方网页搜索卡。开关与 Key 仍走 credentials。
  • 2026-08-17 设置卡左下增加连通测试。无 Key 也可测(走 Tavily keyless);有已存 Key 则走账号档,消耗 1 积分。不改开关、不占用保存。

Author

tonkatsu258

感谢star❤️ tonkatsu258 · 个人网站

← 上一个 Prev dsh-self-evolution 下一个 Next dsh-context-compactor →