dsh-web-search-provider

简体中文

Network search support for the Deepseek Harness, powered by the model provider's server-side capability.

Using this plugin requires the model provider to use the OpenAI Responses API or an Anthropic-compatible Messages API, and to provide a web search capability.

[!TIP] The Anthropic-compatible Messages API only provides a search capability, while the OpenAI Responses API additionally supports viewing a URL's page content / finding specific content within a URL's page. Providers on the OpenAI Responses API are recommended.

[!TIP] Verified to work with: the Deepseek official Messages API (the DSH built-in Deepseek provider), the OpenCode Go Messages API, the OpenCode Go Response API, and an OpenAI relay station's Response API.

[!WARNING] The DSH built-in OpenCode Go provider uses different API types for different models. For example, for its Deepseek V4 Flash/Pro models, to use this plugin's capability you need to manually add a custom provider of the Response / Message API type.

[!WARNING] Some model providers may charge extra for the web search capability this plugin uses.

This plugin does not provide its support through the web_search tool inside the Deepseek Harness, so you can use it alongside other web search provider plugins (such as the built-in web-search-deepseek).

Comparing with web-search-deepseek

TL;DR Compared with web-search-deepseek, this plugin has a clear advantage in both token consumption and time.

web-search-deepseek is the Deepseek Harness's built-in search plugin: when the model in a session calls the web_search tool, it creates a new internal session to run the search and returns several URLs with their content summaries.

Compared with web-search-deepseek, the AI in this plugin's sessions sends the network search request directly to the server, making each individual search faster. Also, the model can directly view / search page content (only with the OpenAI Responses API), reducing the tokens the AI spends on bash/curl to read a page's full content.

Using the Deepseek official Messages API's deepseek-v4-flash model with high think, each plugin performed 5 specified searches per run, tested 10 times:

Plugin	Average tokens	Average time
web-search-deepseek	4,446	47.5s
web-search-provider	822	14.5s

Time is measured from the answer duration shown in the Deepseek Harness. Tokens are the average of the "output" tokens reported on the Deepseek Open Platform, using two different API tokens (because the Deepseek Harness does not count tokens consumed inside tool calls).

The results are for reference only. On tasks that need more web search content, this plugin is expected to show a more pronounced advantage.

Install

dsh plugin add dsh-web-search-provider

---

Or install from source:

pnpm install

Reference the built plugin from a cordis.yml overlay:

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

Config

Settings section web-search-provider (a live namespace: edits reach the next request). All fields are optional unless noted.

Key	Default	Meaning
enabled	true	Master switch; false sends every request down the normal adapter path.
providers	[]	Provider whitelist (llm-pi-ai route keys). A request is served only when its provider is also the current chat route (the plan derives its endpoint facts from that route); the whitelist restricts which of its providers may be served. Empty = serve the current chat route.
baseURL	route	Endpoint base override for the route's candidates; /responses or /messages is appended.
model	loop model	Model override; used by the capability probe and by the served wire request.
apiKeyEnv	route ref	Credential reference resolved per operation.
includeSources	true	Append include: ['web_search_call.action.sources'] to Responses wire requests.
stripServerTools	true	Strip the function-tool variants (web_search/open_page/find_in_page) from the wire tools.
idleTimeoutMs	300000	Idle bound for one inline request, in milliseconds.
probe	true	Verify the endpoint executes native search before serving.
probeTimeoutMs	30000	Bound on one probe request, in milliseconds.

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

Known limitations

• For providers that use the Response API / Message API but do not provide a search capability, the session errors on first use. Keep sending messages / open a new session and DSH keeps working without this plugin's capability.
• When the AI uses this plugin's web search capability, there is no visible search-call UI. The usage may appear as multiple consecutive thinking segments, with the tail of a thinking segment containing something like "Let me make search queries".

Contributing

Building

pnpm install
pnpm build        # tsc emits lib/types, tsdown bundles lib/index.js
pnpm test         # vitest unit suite