deepseekplugins

DeepSeek Harness 插件

dsh-tavily-search-ouones

Tavily-backed search provider (direct Tavily Search API, no LLM tokens) for the DeepSeek Harness web capability seam (ctx.web)（英文原文）

文档与渲染
跳到安装方式

来源信息

GitHub 仓库
ouones/dsh-tavily-search
最近更新
2026年8月14日
分类
文档与渲染
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/ouones/dsh-tavily-search
插件名：dsh-tavily-search-ouones
作者：ouones

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-tavily-search

DeepSeek Harness (DSH) 的 Tavily 网页搜索插件。

通过 Tavily Search API 直连提供 web-search-tavily 网页搜索工具，不消耗任何 LLM token——搜索费用只走 Tavily API 额度，Tavily 本身有免费额度。

特性

  • 直接调用 api.tavily.com/search，无模型参与，搜索不烧 token
  • 注册为 DSH web seam 的搜索 provider（id: tavily-official），工具名为 web-search-tavily
  • 凭据通过 DSH 凭据服务或环境变量注入，API key 由你自己保管
  • 标准 bundle 插件：一条命令装好并自动挂载，无需手改配置
  • 纯 JS（ESM），无构建步骤

安装

需要 DSH 支持的环境（官方要求 Node.js 22.19+）。在 DSH profile 里执行：

dsh plugin --profile web add dsh-tavily-search

装完重启 dsh web 即可使用。dsh plugin 是 profile 目录里的 pnpm 转发层；若首次安装提示 ERR_PNPM_IGNORED_BUILDS，按提示在 profile 的 pnpm-workspace.yaml 的 allowBuilds 里加入相应依赖后重试。

配置

1. 填写 API key

在 Tavily 官网 注册获取自己的 API key，然后任选一种方式提供：

1. DSH 凭据服务（推荐）：把 TAVILY_API_KEY 存进 DSH 的凭据存储； 2. 环境变量：启动 dsh web 前导出 TAVILY_API_KEY； 3. 配置文件里直接写（不推荐，key 会落盘）：见下方覆盖配置中的 apiKey 字段。

2.（可选）覆盖默认配置

插件默认配置（apiKeyEnv: TAVILY_API_KEY、searchDepth: basic、includeAnswer: true）一般够用。需要调整时，在 profile 的 cordis.patch.yml 里按相同的行 id 覆盖：

# ~/.dsh/profiles/<name>/cordis.patch.yml
- id: web-search-tavily
  name: dsh-tavily-search
  config:
    apiKeyEnv: TAVILY_API_KEY   # 环境变量名，默认 TAVILY_API_KEY
    searchDepth: advanced       # basic | advanced，advanced 更贵更慢但更全
    includeAnswer: true         # 是否让 Tavily 生成自然语言回答

> 注意：按 id 覆盖时 config 是整段替换（不是深合并），要改的键都要写上。

3.（可选）把默认搜索切到 Tavily

想让搜索默认走 Tavily、并停用官方 DeepSeek 搜索（避免搜索消耗 LLM token），在 profile 的 cordis.patch.yml 追加：

- id: web
  name: '@deepseek-ai/dsh-web'
  config:
    searchProvider: tavily-official

- id: web-search-deepseek
  name: '@deepseek-ai/dsh-web-search-deepseek'
  disabled: true

4. 重启生效

dsh web

重启后对话里就能用 include:web-search-tavily 工具了。

配置项

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | apiKey | string (secret) | — | 直接写 key（不推荐，会落盘） | | apiKeyEnv | string (credential-ref) | TAVILY_API_KEY | 从凭据服务/环境读取 key 时用的名字 | | baseURL | string | https://api.tavily.com | Tavily API 地址，自建中转时可覆盖 | | searchDepth | string | basic | basic \| advanced | | includeAnswer | boolean | true | 是否返回 Tavily 生成的自然语言回答 |

验证是否装好

dsh --profile web --dump-config   # 应出现 id: web-search-tavily 这一层

常见问题

Q: 搜索报 WEB_PROVIDER_CREDENTIAL_MISSING？ A: 没找到 key。确认 TAVILY_API_KEY 已通过凭据服务或环境变量提供，或检查 apiKeyEnv 拼写。

Q: 和官方 DeepSeek 搜索有什么区别？ A: 官方搜索走 DeepSeek 模型调用（每次搜索消耗 LLM token）；本插件直连 Tavily，只花 Tavily 额度。

Q: API key 会被共享吗？ A: 不会。key 只存在于你自己的 DSH 凭据存储/环境变量里，插件代码中没有任何 key，也不会上传任何 key。

License

MIT

返回搜索打开 GitHub 仓库

更多相关插件

查看分类