dsh-web-search-router
按优先级选择搜索提供方，并在失败、限流或无结果时自动切换。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Kerberos255/dsh-web-search-router#bd76fd5d4800dd5cf297b6a5522447393585b977Web Search Router 以 dsh-web-search-router 发布，当前版本为 0.2.13。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
简体中文 · DeepSeek Harness · Security
A priority-ordered, multi-provider web_search router for DSH. Keep the model-facing tool unchanged while automatically switching providers when one is unavailable.
The plugin registers one DSH web search provider (web-search-router) and keeps the model-facing tool unchanged: agents still call DSH's built-in web_search. Providers are tried from top to bottom and the router stops on the first successful result.
plugins/dsh-web-search-router/config.json next to $DSH_HOME and apply without restarting DSH.| Provider | Configuration |
|---|---|
| SearXNG | Base URL in Settings (no API key required) |
| DeepSeek Search | Delegates to the deepseek-official provider DSH itself registers: the account sign-in, or the shared DEEPSEEK_API_KEY credential |
| Tavily | TAVILY_API_KEY |
| Brave Search | BRAVE_API_KEY |
| Exa | EXA_API_KEY |
| Firecrawl | FIRECRAWL_API_KEY |
| Parallel | PARALLEL_API_KEY |
| DuckDuckGo | No key; best-effort HTML fallback |
Unconfigured providers are skipped automatically.
Check package.json for the runtime and peer-dependency constraints supported by the current source. DeepSeek Harness is under active development and may introduce compatibility-breaking changes. Pin the plugin to a Git commit when reproducibility matters, and retest when upgrading DSH.
This plugin supplies the search backend; it does not add a second model-facing tool. Your agent preset must expose DSH's built-in web_search tool (for example, the standard preset). A minimal preset that omits web_search will not invoke this router.
Install to the profile that runs your agents (desktop is an example):
dsh plugin --profile desktop add github:Kerberos255/dsh-web-search-router
For reproducible installations, pin a Git commit. Local development can instead use link:/absolute/path/to/dsh-web-search-router with the same profile. Installing the plugin does not add web_search to a preset that omits the native tool.
The bundled patch selects web-search-router as DSH's search provider and inserts the plugin with generic defaults.
Open Settings → Plugins → Plugin configuration → Web Search Router and expand the card to:
Non-secret settings live in plugins/dsh-web-search-router/config.json next to $DSH_HOME; the card reads and writes that file.
Settings writes are accepted only from loopback access. API keys are written through DSH credentials; the UI only reads configured/unconfigured state.
The DeepSeek tier configures nothing of its own: it calls the deepseek-official provider DSH
itself registered, so the endpoint, the model, the account-or-key authentication, and the
per-request limits all stay owned by DSH. Changing the endpoint in DSH's own Web search settings
needs no extra step here.
The tier is attempted only while that provider is registered and the session can plausibly
authenticate — a session on the deepseek-account route, or the shared DEEPSEEK_API_KEY
credential the Models page manages for chat. Otherwise the router skips to the next provider.
For each enabled provider, in configured order:
Caller aborts are propagated immediately and never trigger fallback.
npm test
Tests cover routing order/fallback/cooldowns, settings persistence and provider request/response adapters. Live tests used during local development are intentionally excluded from the public repository because they depend on a running local DSH instance and local credentials.
.env files.The plugin optionally emits privacy-restricted operation and failure metadata to dsh-plugin-diagnostics. Diagnostics contain event type, status, fixed error code and elapsed time; conversation content and credentials are not logged. The diagnostics plugin is optional and does not change the host requirements.