DeepSeek Harness (DSH) provides web search capabilities through the ctx.web slot. When using the base package, developers may need to integrate search services from specific sources or decouple search billing from model inference billing. dsh-web-search-doubao is a community plugin that plugs Doubao search services into the DSH ctx.web slot and provides standalone search functionality.
Basic Information¶
This is a community-maintained plugin, maintained by developer kenny2077 and released under the MIT license. It does not depend on the official DeepSeek base package, registers its Provider through cordis.patch.yml, and does not affect the operation of the DSH base package.
Core Features¶
- Doubao Search Service: Provides Web search results based on Volcengine Doubao search.
- Independent Billing: The search service is billed separately and does not consume model tokens, preventing confusion between search costs and model inference fees.
- Slot Insertion: Inserts the provider into the
ctx.webslot using the Seam pattern and maintains an interface consistent with native DSH providers. - Dual Version Support: Provides
customandglobalversions, corresponding to different API response formats and result lengths. - Runtime Configuration: Supports modifying settings at runtime (such as version, endpoint, snippet length, etc.) without restarting the DSH process.
- Secure Credential Storage: Stores API keys through the DSH credential service rather than writing them directly to configuration files.
Installation and Activation¶
Before installation, ensure that DeepSeek Harness (DSH) is installed and the dsh CLI is available.
- Install from npm:
dsh plugin add dsh-web-search-doubao
- Install from GitHub (no build required):
dsh plugin add github:kenny2077/dsh-web-search-doubao
The installation command will register the Provider through cordis.patch.yml and switch the active searchProvider to doubao.
Configuration and Usage¶
Obtain the API Key and Configure¶
The plugin provides a standalone Web Search (Doubao) settings card. API keys must be managed through the credential service rather than through configuration files.
- Obtain an API Key: Enable the service in the Doubao search console and create an API Key. A free quota of 500 searches per month is provided.
- Configure: Enter the key in the “Web Search (Doubao)” card in the Harness settings GUI. Settings include version (custom/global), base URL, etc., and changes take effect immediately.
Use the Search Tool¶
After configuration, in Harness, use the web_search tool to invoke Doubao search. The plugin normalizes search results into the WebSearchResult format and returns them to the model.
Notes¶
- Not an Ark Plugin: This is not a Volcengine Ark (Ark) chat-side web content plugin. It uses Doubao search’s standalone API, and the search process is completely decoupled from model inference.
- Source Code Review: As a community plugin, it is recommended to review the source code and license before use.
- Dependency Environment: The plugin depends on DSH’s Seam insertion mechanism and runs with the permissions of the current DSH process.
Ecosystem Background¶
The core concept of DeepSeek Harness is “everything is a plugin.” This plugin is one of the tools built by community developers to enrich the ecosystem and has no direct affiliation with DeepSeek. The community catalog provides index information for the plugin.
- GitHub Repository: https://github.com/kenny2077/dsh-web-search-doubao
- Community Catalog: https://www.skillhub.cn/plugins/kenny2077/dsh-web-search-doubao