dsh-search-boost
适用于 DeepSeek Harness 的多引擎融合网页搜索、页面抓取、带有无凭据回退机制的实时 X (Twitter) 搜索、深度研究和并行多智能体研究。免费层：Bing / DuckDuckGo / Yahoo / Exa MCP（均无需密钥，并经过实时探测）；api la
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-search-boost@0.1.3Search Boost 以 dsh-search-boost 发布，当前版本为 0.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Search boost for DeepSeek Harness (DSH): multi-engine fused search, focused page fetching, X (Twitter) search, step-mode deep research, parallel multi-agent research, and an injected proactive-search policy.
A bundle plugin for DSH that upgrades the built-in web_search / web_fetch and registers a family of search tools.
Two layers, switched at runtime with /web_change (persisted to ~/.dsh-search-boost-layer.json):
| Layer | Engines dialed | When to use |
|---|---|---|
free (keyless only) | Bing + DuckDuckGo + Yahoo + Exa MCP (exa-free) — all live-probed, no API keys | Research loops, zero-cost runs, privacy-conscious use |
api (default) | Same keyless legs plus Antigravity CLI (when agy is on PATH) and keyed Tavily / Brave / Exa (when keys are present) | Maximum recall; cross-engine corroboration with paid APIs |
Keyless engines run in parallel so one failure never leaves you empty-handed. Fused ranking adds cross-engine co-occurrence scoring and half-life time-decay freshness.
| Capability | Description |
|---|---|
Built-in web_search + web_fetch upgrade | Registers WebSearchProvider + WebFetchProvider and patches both seam configs, so built-in search/fetch keep native citation cards while the backend runs on this plugin's engine chain and Jina-first page reader |
fused_search | Multi-engine fused retrieval with complexity routing, Grok-style query preprocessing (site: / OR / quotes), domain filters, cross-engine scoring, and 6h TTL cache. Active layer via /web_change; per-call layer override supported |
/web_change | /web_change free → keyless pool only; /web_change api → full pool; /web_change show → current layer + engine availability |
x_search | Real-time X/Twitter: posts, users, threads. With credentials: hosted xAI tool ∥ multi-engine (site:x.com), merged and deduped. Without credentials: multi-engine + oEmbed full text (~2s), guest GraphQL user profiles, oEmbed threads. /x-login / /x-logout toggle the official path |
/x-login | Import xAI credentials into ~/.dsh-search-boost-xauth.json (from ~/.grok/auth.json or -k <XAI_API_KEY>). OIDC auto-refresh; grok CLI login untouched |
/x-logout | Remove /x-login credentials; x_search falls back to the credential-free chain |
fetch_page | Jina Reader + local HTML fallback + focus topic extraction + 24h cache |
deep_research | Step-mode deep research: complex fused search + coverage analysis + gaps + suggested queries, driven by the main agent in rounds |
research_parallel | Sub-query decomposition → native DSH subagents in parallel → merged sources |
search_stats | Cache / tier / engine availability / x_search credential audit |
| Search policy | Injected via systemPrompt.section: verify time-sensitive facts, route X content to x_search, prefer free engines |
From npm (recommended):
dsh plugin --profile web add dsh-search-boost # latest
dsh plugin --profile web add dsh-search-boost@0.1.3 # pin a version
dsh plugin --profile web update dsh-search-boost # update to a newer release
--profile <name> is required (web is the standard web-UI profile). DSH uses pnpm to resolve the package, auto-wires the dsh.bundle.patch layer, and adds it to the profile's bundle list — no manual config editing. Restart dsh --profile web.
From source (development):
dsh plugin --profile web add github:Mr-remon219/dsh-search-boost
dsh plugin --profile web add git+file:///path/to/repo
Or use the install script (syntax check → key setup → install → verification):
.\install.ps1 # Windows
./install.sh # Linux / macOS
Verify:
dsh --profile web --dump-config # web.searchProvider → dsh-search-boost
dsh --profile web
dsh or pnpmIf you run DSH via npx @deepseek-ai/dsh web, there is no global dsh binary — install globally or use npx directly:
npm install -g @deepseek-ai/dsh
# or:
npx --yes @deepseek-ai/dsh plugin --profile web add dsh-search-boost
dsh plugin needs pnpm (npm install -g pnpm or corepack).
plugin-host.js)plugin-host.js is a single-file dynamic plugin for per-session boosts. It does not replace built-in web_search. The bundle form (above) is recommended for deployment-level integration.
The published bundle contains no secrets. Keys load from:
~/.dsh-search-boost-keys.json or ./.search-boost-keys.json:{ "tavily": "tvly-...", "exa": "...", "brave": "..." }
TAVILY_API_KEY / EXA_API_KEY / BRAVE_API_KEYEngines without a key are dropped from the fan-out automatically.
Free layer needs zero configuration. Bing, DuckDuckGo, Yahoo, and Exa MCP (exa-free) are keyless and run in parallel. Antigravity CLI (agy) is optional and only joins in the api layer (medium/complex tiers) when installed and signed in.
| Command | Effect |
|---|---|
/x-login | Import grok login → official hosted x_search path (SuperGrok / X Premium+ tier) |
/x-login -k <XAI_API_KEY> | Same via console.x.ai API key |
/x-login status | Show credential chain |
/x-logout | Disable official path; fallback chain still works |
~/.grok/auth.json is never auto-consumed. Without /x-login or XAI_API_KEY, x_search uses only the credential-free chain.
Live benchmark (node scripts/engine-benchmark.mjs); full report in scripts/engine-benchmark-report.json.
| Engine | Success | Avg latency | Verdict |
|---|---|---|---|
| bing | 100% | ~2.0s | ✅ free layer |
| ddg | 100% | ~2.2s | ✅ free layer |
| yahoo | 100% | ~2.3s | ✅ free layer (new in v0.1.2) |
| exa-free | 100% | ~4.2s | ✅ free layer |
| antigravity | 92% | ~27s | api layer only (slow, needs agy CLI) |
| brave-html / mojeek / searx | 0% | — | rejected (429, blocked, or unreachable) |
| Scenario | Result |
|---|---|
free layer fused_search | 5 hits in ~1.3–3.0s; cross-engine corroboration (e.g. yahoo+exa-free → score 3.29 on rust release notes) |
x_search (no credentials) | keyword via multi-engine + oEmbed; user via guest GraphQL (@NASA ~2s); thread via oEmbed |
| SSRF vs Clash TUN fake-ip | Literal 198.18/15 blocked; TUN-routed hostnames allowed (DSH_SEARCH_ALLOW_TUN_FAKEIP=0 to disable) |
Headless web_search | ✓ free Bing/DDG/Yahoo/Exa chain |
| Unit + E2E tests | 57/57 unit tests; 14/14 black-box E2E |
fetch / child_process directly).lib/xsearch.js) → credential-free chain (lib/xfallback.js: multi-engine + oEmbed + guest GraphQL) with sync preflight when no credentials.index.js — bundle entry (providers + tools + commands + policy)
lib/engines.js — engine registry (bing / ddg / yahoo / exa-free / …)
lib/exa-free.js — Exa MCP keyless engine
lib/layer.js — free/api layer state (/web_change)
lib/fusion.js — fusion scoring, tier tables, cache
lib/fetch.js — Jina Reader + focus extraction
lib/xauth.js / xsearch.js / xfallback.js — x_search credential + official + fallback paths
lib/research.js — deep_research + research_parallel
lib/policy.js — proactive-search policy
cordis.patch.yml — DSH patch layer manifest
scripts/engine-benchmark.mjs — maintainer: live free-engine probe
npm test
npm publish # prepublishOnly: syntax + tests + clean git tree
MIT