paul-yangmy / dsh-tavily-web-search

Listed

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

mainModelTool View source

Installation

npx -y @deepseek-ai/dsh plugin --profile web add github:paul-yangmy/dsh-tavily-web-search

This installation command is an unverified starting point generated from the GitHub repository address.

README

Maintainer-authored documentation snapshot.

View on GitHub ↗
Commit 20175a7Synced Aug 17, 2026

简体中文 | English

让 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>
  1. 在 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

Project files and signals

Shown items are public repository signals detected in the directory snapshot.

TestsDetected

Repository information

Language
JavaScript
License
MIT
Last updated
Aug 17, 2026, 9:03 AM

Install deliberately

Review source code, permissions, lifecycle hooks, dependencies and network access. Test untrusted plugins in an isolated environment.