服务端联网搜索 hiyms/dsh-web-search-provider

dsh-web-search-provider

npm version

为 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 单元测试