dsh-web-search-provider

为 Deepseek Harness 引入基于模型供应方服务器能力的网络搜索支持。

本插件使用时要求模型供应方使用 OpenAI Responses API 或 Anthropic 兼容 Messages API ，同时提供网络搜索能力。

[!TIP] Anthropic 兼容 Messages API 仅提供了搜索能力，而 OpenAI Responses API 则支持在查看 URL 对应网页内容/从 URL 对应网页查找特定内容。推荐使用 OpenAI Responses API 供应方。

[!TIP] 经实测，Deepseek 官方 Messages API（即 DSH内置的 Deepseek 供应方）、OpenCode Go Messages API、OpenCode Go Response API 和某 OpenAI 中转站 Response API 均能与本插件配合工作。

[!WARNING] DSH 内置的 OpenCode Go 供应方对不同模型使用的 API 类型不同。如对于其提供的 Deepseek V4 Flash/Pro 模型，如期望使用本插件提供的能力，需要手动添加 Response / Message API 类型的自定义供应方。

[!WARNING] 部分模型供应方对本插件使用的网络搜索能力可能进行额外收费。

本插件不通过 Deepseek Harness 内的 web_search 工具提供支持，因而你可以将本插件与其它 web search provider 插件（如内置的 web-search-deepseek）配合使用。

比较 web-search-deepseek

TL;DR 本插件相比 web-search-deepseek ，在消耗词元、消耗时间上均有明显优势。

web-search-deepseek 是 Deepseek Harness 内置的搜索插件，当会话中模型调用 web_search 工具时，其会在内部新建一个会话进行搜索，并返回若干个网址及其内容摘要。

本插件相比 web-search-deepseek ， 会话中 AI 直接向服务器发起网络搜索请求，单次搜索速度更快。同时，模型可以直接查看/搜索网页内容（仅 OpenAI Responses API 支持），减少 AI 为了查看网页所有内容，使用 bash/curl 消耗的词元。

使用 Deepseek 官方 Messages API 的 deepseek-v4-flash model with high think ，分别使用两个插件，每次进行5次指定的搜索，测试十次：

插件	平均消耗词元	平均消耗时间
web-search-deepseek	4,446	47.5s
web-search-provider	822	14.5s

消耗时间统计自 Deepseek Harness 中显示的回答耗时。消耗词元统计自 Deepseek 开放平台取"输出"词元平均数，通过使用两个不同的 API 令牌（因为 Deepseek Harness 不统计工具调用内消耗的词元）。

测试结果仅供参考。在需要更多网络搜索内容的任务中，预期本插件有更明显的优势。

安装

dsh plugin add dsh-web-search-provider

---

或从源代码安装：

pnpm install

在 cordis.yml 覆盖层中引用构建后的插件：

- insert:
    - id: web-search-provider
      name: 'dsh-web-search-provider'
      config:
        enabled: true
        probe: true

配置

设置段 web-search-provider（实时命名空间：改动对下一次请求生效）。除注明外所有字段均可选。

键	默认	含义
enabled	true	总开关；false 时所有请求走普通适配器路径。
providers	[]	Provider 白名单（llm-pi-ai 路由键）。请求的 provider 必须是当前聊天路由（计划从该路由推导端点事实）才会被服务；白名单只限制该路由中哪些 provider 可被服务。空 = 服务当前聊天路由。
baseURL	路由	路由候选的端点基址覆盖；追加 /responses 或 /messages。
model	loop 模型	模型覆盖；探测和实际 wire 请求都使用它。
apiKeyEnv	路由引用	每次操作经凭证引用解析。
includeSources	true	向 Responses wire 请求追加 include: ['web_search_call.action.sources']。
stripServerTools	true	从 wire 工具中剔除函数工具变体（web_search/open_page/find_in_page）。
idleTimeoutMs	300000	单次 inline 请求的空闲上限（毫秒）。
probe	true	服务前用一次有界请求验证端点确实执行原生搜索。
probeTimeoutMs	30000	单次探测请求的上限（毫秒）。

- id: web-search-provider
  name: 'dsh-web-search-provider'
  config:
    enabled: true
    probe: true

已知限制

• 对于使用 Response API / Message API 但不提供搜索能力的供应方，在首次使用时会话会报错。继续发送消息/新开会话即可在无本插件能力的同时继续使用 DSH。
• AI 使用本插件提供的网络搜索能力时，无显示搜索调用 UI。可能的使用表现为多端连续的思考内容，段思考尾部包含“Let me make search queries” 等字样。

参与贡献

编译

pnpm install
pnpm build        # tsc 产出 lib/types，tsdown 打包 lib/index.js
pnpm test         # vitest 单元测试