DSH Web Search: Tavily

中文 | English

为 DeepSeek Harness 的 web seam 提供 Tavily 联网搜索能力，安装后即可让 agent 获取带标题、链接和摘要的实时网页结果。

以稳定 id tavily-search 注册一个联网搜索 provider，并通过随包提供的 cordis.patch.yml 把它设为该 profile 的默认搜索 provider。

• 调用 POST https://api.tavily.com/search（bearer 认证），返回 Tavily 结构化的 results[]（title、url、content、published_date）——这种结构正是为 AI agent 设计的。
• 凭据按次解析、绝不保存，顺序为：插件 config 中的字面量 apiKey — credentials.resolve(TAVILY_API_KEY) — 兜底 credentials.resolve(DEEPSEEK_API_KEY)。
• 从 profile 中移除该 bundle，即可同时撤销 provider 注册与默认搜索设置。

快速开始

dsh plugin --profile web add github:wakeup595626-cmyk/dsh-plugin-websearch-tavily

该包尚未发布到 npm，请使用上面的 GitHub 安装方式。安装或更新后重启 dsh web。

使用

1. 获取 Tavily API Key（额度与计费以你的 Tavily 账户为准）。
2. 通过插件 config 传入，或让 host 能解析到 TAVILY_API_KEY。
3. 像平常一样向 agent 提问需要联网搜索的内容。

在 DeepSeek Harness 的联网搜索设置中保存 TAVILY_API_KEY，或启动 host 前设置环境变量：

$env:TAVILY_API_KEY = "tvly-..."

export TAVILY_API_KEY="tvly-..."

不要把真实 key 提交到仓库或写进 README。

环境要求

• 已安装 DeepSeek Harness
• 你自己的 Tavily API Key

配置项

字段	默认值	说明
apiKey	无	本地临时使用的字面量密钥；优先使用凭据服务
apiKeyEnv	TAVILY_API_KEY	环境变量或凭据引用名
searchDepth	basic	Tavily 搜索深度
maxResults	5	返回结果数量
topic	general	Tavily 搜索主题
includeAnswer	false	是否请求 Tavily 的聚合答案

隐私与网络边界

搜索内容会发送到你配置的 Tavily API；调用频率与费用受 Tavily 账户额度约束。插件本身不保存 key，也不代理其他流量。

第三方声明

本插件在运行时调用 Tavily 搜索 API，需要你自己的 API Key，并受 Tavily 服务条款约束。包内不含任何第三方代码。

详见 THIRD_PARTY_NOTICES.zh.md（English）。

社区与支持

• 通过 GitHub Issues 报告问题与提问。
• 在 awesome-dsh-plugin.com 浏览更广阔的插件生态。

参与贡献

参见 CONTRIBUTING.zh.md（English）。

引用

@misc{dsh-plugin-websearch-tavily,
  title={dsh-plugin-websearch-tavily},
  author={wakeup595626-cmyk},
  year={2026},
  publisher={GitHub},
  howpublished={\url{https://github.com/wakeup595626-cmyk/dsh-plugin-websearch-tavily}},
}

许可证

MIT