dsh-web-search-tavily
在终端中运行以下命令:
dsh plugin install cxykyw/dsh-web-search-tavily
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install cxykyw/dsh-web-search-tavily,或从 https://github.com/cxykyw/dsh-web-search-tavily 获取源码后按 README 加入 profile 工作区。
插件介绍
DeepSeek Harness 的联网能力里,内置 web_search 默认走模型侧通道:每次检索都会占用对话 token,且结果未必来自真实搜索引擎索引。若你希望「搜一次网页」更像传统搜索、成本也更可控,就需要在 ctx.web 上挂一个独立的搜索提供方。
dsh-web-search-tavily(npm 包名为 dsh-tavily-cxykyw)在稳定 ID tavily 下注册 WebSearchProvider,把 web_search 请求转发到 Tavily 专用 API。返回会映射为 DSH 统一的 WebSearchResult:条目 URL、标题与摘要进入 sources,Tavily 可选的综合回答可作为正文内容;结果数量仍按请求的 maxResults 在 seam 层截断,行为与其他提供方一致。
密钥在每次搜索时按顺序解析:配置中的明文 apiKey、凭据服务(~/.dsh/.credentials.yaml)、或启动环境变量;available() 只做本地检查(密钥与 base URL),缺密钥会在真正搜索时以 WEB_PROVIDER_CREDENTIAL_MISSING 报错。可通过 profile 补丁配置搜索深度(basic/advanced)、单次结果上限与 API 地址等;bundle 补丁还会把 web.searchProvider 设为 tavily。页面抓取 fetch 不受影响,仍使用官方 HTTP fetch 插件。
适合已在 DSH 0.2 使用联网、并持有 Tavily API Key(含免费档)的开发者或团队:需要可预期的搜索计费、更贴近索引的引用来源,且愿意用 profile 补丁管理配置(当前版本暂无 Web 设置页)。若要恢复官方 DeepSeek 搜索,可将 searchProvider 改回 deepseek-official。
使用场景
- 希望 web_search 走真实搜索引擎索引而非模型侧检索
- 需要控制联网成本、避免每次搜索消耗对话 token
- 在 profile 中固定使用 Tavily 并调节深度与结果条数
适合人员
- 使用 DSH 0.2 联网能力与 web_search 的开发者
- 已申请 Tavily API Key、接受用 profile 补丁配置的用户
- 关注引用来源质量与可预期搜索计费的技术团队