前言¶
DeepSeek Harness(DSH)的插件生态强调「一切皆插件」,社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系。对 DSH 使用者来说,联网搜索不一定只能走 DSH 内置的 web_search 工具链路。dsh-web-search-provider 提供另一种路径:使用模型提供方的服务端搜索能力。
这是什么¶
dsh-web-search-provider 由 hiyms 维护,采用 MIT 许可证。它为 DeepSeek Harness 提供基于模型提供方服务端搜索能力的联网搜索支持。
使用它需要满足以下条件:
- 模型提供方使用
OpenAI Responses API或Anthropic-compatible Messages API - 提供方本身提供
web search capability
它不通过 DSH 内置的 web_search 工具实现,因此可以与其他 web search provider 插件同时使用。在 OpenAI Responses API 下,它还能直接查看或搜索 URL 页面内容。
安装与启用¶
先安装插件:
dsh plugin add dsh-web-search-provider
如果从源码安装,可以执行:
pnpm install
然后在 cordis.yml overlay 中引用插件:
- insert:
- id: web-search-provider
name: 'dsh-web-search-provider'
config:
enabled: true
probe: true
上面配置先启用插件,并打开 probe。
配置¶
配置节为 web-search-provider。可设置以下项:
enabled:启用或禁用插件能力providers:提供方白名单baseURL:端点覆盖model:模型覆盖apiKeyEnv:API key 覆盖includeSources、stripServerTools、idleTimeoutMs、probe、probeTimeoutMs:请求、超时和探测相关配置
典型用法¶
下面介绍几个使用前需要确认的点。
- 建议优先使用
OpenAI Responses API提供方,因为它额外支持查看或搜索 URL 页面内容。 - 如果提供方使用
Response API/Message API,但不提供web search capability,会话首次使用可能报错;DSH 会在没有该插件能力的情况下继续工作。 - 当模型使用此插件的 web search 能力时,可能没有可见的 search-call UI,也可能表现为连续 thinking 段。
- 部分模型提供方可能对 web search 能力额外收费,使用前确认计费方式。
- DSH 内置
OpenCode Goprovider 对不同模型使用不同 API 类型;若要使用该插件能力,可能需手动添加Response/MessageAPI 类型的自定义 provider。
安全与检查¶
该插件以当前 dsh 进程权限运行。安装前建议检查源码与 MIT 许可证,确认其读取的配置、凭据和发送请求的范围符合预期。
链接¶
- GitHub:https://github.com/hiyms/dsh-web-search-provider
- 社区目录:未在本篇附确定 URL,可按插件名
dsh-web-search-provider在 DSH 插件目录中查找。