前言¶

DeepSeek Harness (DSH) 的插件化架构允许开发者根据需要扩展功能。在 Web 能力中，内置的 web_search 工具通常需要外部网关支持才能执行真实的网络检索。dsh-web-search-tokenrhythm 插件正是为了解决这一问题而生，它将 DSH 的内置工具对接到 Token Rhythm 网关的 OpenAI Responses API。

这是什么¶

这是一个由 Joeytisaly 维护的插件。它的核心作用是将 DSH 的内置 web_search 工具转化为通过 Token Rhythm 网关的真实搜索请求。该插件复用用户已保存的 DEEPSEEK_API_KEY，无需注册新的账号或获取新的密钥。

安装与启用¶

安装需要进入 dsh 的配置文件目录（例如 %USERPROFILE%\.dsh\profiles\web）。

1. 在该目录下执行安装命令：

   pnpm add dsh-web-search-tokenrhythm

2. 编辑 profiles/web/package.json，在 dsh.profile.bundles 数组中添加 "dsh-web-search-tokenrhythm"。

3. 重启 dsh web 以激活该提供者。

核心功能¶

• 真实搜索：通过 Token Rhythm 网关的 OpenAI Responses API 执行真实的网络搜索。
• 复用密钥：自动读取已保存的 DEEPSEEK_API_KEY，无需额外的认证配置。
• 自动挂载：当插件被列在配置文件的 bundles 中时，会自动挂载提供者。
• 原生支持：支持 OpenAI Responses API 中原生的 web_search 工具。
• 自动重试：针对网关返回的 transient 503 错误，会自动重试最多 maxRetries 次（默认为 2 次）。

典型用法¶

在 DSH 的聊天界面中，直接向智能体提问即可触发搜索。
示例：
* “帮我搜一下 XXX”
* “search the web for XXX”

插件激活后，智能体的回复中会包含真实的搜索来源链接。

适用场景与前置条件¶

• 前置条件：
  • 你的网关必须支持带有原生 web_search 工具的 OpenAI Responses API。
  • 必须在设置中保存 API 密钥（默认引用为 DEEPSEEK_API_KEY）。
• 注意：
  • 搜索结果可能仅返回打开页面的 URL，不包含结构化的标题或摘要。
  • 如果网关不支持 web_search 工具，此插件无法工作。

总结¶

该插件通过复用现有密钥和配置，简化了在 DSH 中接入真实网络搜索的流程。对于需要联网能力的智能体开发，这是一个直接可用的方案。

更多详情可参考：
* GitHub 仓库：https://github.com/Joeytisaly/dsh-web-search-tokenrhythm
* 社区目录：https://www.skillhub.cn/plugins/Joeytisaly/dsh-web-search-tokenrhythm