DeepSeek Harness plugin

dsh-tavily-web-search

Tavily-backed web search provider plugin (bundle) for DeepSeek Harness — registers a ctx.web search provider using the Tavily REST API

Jump to install

Source facts

Repository
paul-yangmy/dsh-tavily-web-search
Latest update
Aug 17, 2026
Category
Docs & Rendering
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/paul-yangmy/dsh-tavily-web-search
Plugin: dsh-tavily-web-search
Author: paul-yangmy

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-tavily-web-search

<p align="center">

<strong>简体中文</strong> | <a href="README.en.md">English</a>

</p>

让 DSH 的 web_search 通过 Tavily 返回更完整的搜索结果:除了链接列表,还有 Tavily 生成的摘要答案和结构化引用来源。

安装

推荐直接安装到 DSH 的 web profile:

dsh plugin --profile web add github:paul-yangmy/dsh-tavily-web-search
# 如果 dsh web 正在运行,重启后刷新页面

运行 dsh --profile web --dump-config 确认插件已经进入最终配置。需要本地开发时,克隆仓库后在仓库目录运行 dsh plugin --profile web add .;源码为纯 JS,不需要额外构建。

怎么用

1. 在 Tavily 控制台创建 API Key。 2. 把 API Key 写入 DSH 凭据服务:

# $DSH_HOME/.credentials.yaml
TAVILY_API_KEY: tvly-<your-key>

3. 在 DSH 中让模型搜索网页。插件加载后会自动把 web_search 的搜索提供者设为 tavily,返回结果包含摘要 content,以及带 title / snippet / publishedAt 的引用源。

可选配置(默认值一般不用改):

# settings.yaml
web-search-tavily:
  baseURL: https://api.tavily.com
  apiKeyEnv: TAVILY_API_KEY

如果你的 DSH profile 不是 web,把安装和 --dump-config 命令里的 web 换成你的 profile 名。

安全

API Key 不会打进插件包,也不会写入代码。每次搜索按 apiKey 字面量(不推荐)→ 凭据服务 → 启动环境变量的顺序解析。推荐使用 DSH 凭据服务,密钥支持热更新,无需重启。

限制

  • 目前固定使用 Tavily search_depth: "basic",不暴露 advanced 深度选项。
  • max_results 受工具层约束,并硬上限为 20(Tavily 文档上限)。
  • 实际可用性取决于 Tavily 服务与网络。
  • 若同时安装多个搜索提供者插件,最后安装的插件层按行胜出;需要换回其他提供者时,在 profile 的 cordis.patch.yml 覆盖 web.searchProvider

License

MIT