搜索增强 Mr-remon219/dsh-search-boost

dsh-search-boost

为 DeepSeek Harness（DSH）提供搜索增强：多引擎融合搜索、聚焦式页面抓取、X（Twitter）搜索、分步深度研究、并行多智能体研究，以及注入式主动搜索策略。

这是 DSH 的捆绑插件，用来升级内置的 web_search / web_fetch，并注册一整套搜索工具。

search-boost 家族

| 项目 | 适用对象 | 链接 |
| search-boost | 通过 MCP 支持 Cursor · Codex · Claude · Grok · Antigravity | GitHub · npm |
| dsh-search-boost （本仓库） | DeepSeek Harness 捆绑插件 | 你在这里 |
| pi-search-boost | pi 扩展 | GitHub · npm |

搜索引擎都在 lib/ 里：free 层让 Bing、DuckDuckGo、Yahoo、Exa-free 并行跑；api 层再加上 Antigravity CLI（可用时）以及带密钥的 Tavily / Brave / Exa（有密钥时）。一个密钥就够，三个都配融合效果最好。

中文文档 → README_zh.md

搜索分层

两层，运行时用 /web_change 切换（持久化到 ~/.dsh-search-boost-layer.json）：

| 层 | 拨入的引擎 | 适用场景 |
| free（仅无密钥） | Bing + DuckDuckGo + Yahoo + Exa MCP（exa-free） —— 全部实时探测，无需 API 密钥 | 研究循环、零成本运行、注重隐私的场景 |
| api（默认） | 同样的无密钥分支，外加 Antigravity CLI（agy 在 PATH 上时）和带密钥的 Tavily / Brave / Exa（有密钥时） | 最大召回；用付费 API 做跨引擎互证 |

无密钥引擎并行运行，所以某一个挂掉也不会让你空手而归。融合排序加入跨引擎共现打分和半衰期时间衰减新鲜度。

功能

| 能力 | 说明 |
| 内置 web_search + web_fetch 升级 | 注册 WebSearchProvider + WebFetchProvider，并给两处 seam 配置打补丁，这样内置搜索/抓取保留原生引用卡片，而后端跑在本插件的引擎链和 Jina 优先的页面读取器上 |
| fused_search | 多引擎融合检索，带复杂度路由、Grok 风格查询预处理（site: / OR / 引号）、域名过滤、跨引擎打分，以及 6h TTL 缓存。当前层由 /web_change 决定；支持按调用用 layer 覆盖 |
| /web_change | /web_change free → 只用无密钥池；/web_change api → 全量池；/web_change show → 当前层 + 引擎可用性 |
| x_search | 实时 X/Twitter：帖子、用户、话题串。带凭据时：托管 xAI 工具 ∥ 多引擎（site:x.com），合并去重。不带凭据时：多引擎 + oEmbed 全文（约 2 秒）、访客 GraphQL 用户资料、oEmbed 话题串。/x-login / /x-logout 切换官方路径 |
| /x-login | 把 xAI 凭据导入 ~/.dsh-search-boost-xauth.json（来自 ~/.grok/auth.json 或 -k <XAI_API_KEY>）。OIDC 自动刷新；grok CLI 登录不受影响 |
| /x-logout | 删除 /x-login 写入的凭据；x_search 回退到免凭据链路 |
| fetch_page | Jina Reader + 本地 HTML 兜底 + focus 主题提取 + 24 小时缓存 |
| deep_research | 分步深度研究：复杂融合搜索 + 覆盖度分析 + 缺口 + 建议查询，由主智能体分轮驱动 |
| research_parallel | 子查询拆解 → 原生 DSH 子代理并行执行 → 合并来源 |
| search_stats | 缓存 / 分层 / 引擎可用性 / x_search 凭据审计 |
| 搜索策略 | 通过 systemPrompt.section 注入：核实时效性事实，把 X 内容路由到 x_search，优先使用免费引擎 |

安装（bundle，推荐）

从 npm 安装（推荐）：

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> 是必填项（web 是标准 Web UI 配置档）。DSH 用 pnpm 解析包，自动接好 dsh.bundle.patch 层，并把它加入配置档的 bundle 列表——不用手动改配置。重启 dsh --profile web。

从源码安装（开发用）：

dsh plugin --profile web add github:Mr-remon219/dsh-search-boost
dsh plugin --profile web add git+file:///path/to/repo

也可以用安装脚本（语法检查 → 密钥设置 → 安装 → 验证）：

.\install.ps1 # Windows
./install.sh # Linux / macOS

验证：

dsh --profile web --dump-config # web.searchProvider → dsh-search-boost
dsh --profile web

排障：找不到 dsh 或 pnpm

如果你用 npx @deepseek-ai/dsh web 运行 DSH，就没有全局 dsh 可执行文件——要么全局安装，要么直接用 npx：

npm install -g @deepseek-ai/dsh
or:
npx --yes @deepseek-ai/dsh plugin --profile web add dsh-search-boost

dsh plugin 需要 pnpm（npm install -g pnpm 或 corepack）。

备选方案：会话级动态插件（plugin-host.js）

plugin-host.js 是单文件动态插件，用于按会话增强。它不替换内置 web_search。部署级集成推荐用上面的 bundle 形式。

配置（API 密钥）

已发布的 bundle 不含任何密钥。密钥从以下位置加载：

1. ~/.dsh-search-boost-keys.json 或 ./.search-boost-keys.json：

{ "tavily": "tvly-...", "exa": "...", "brave": "..." }
2. 环境变量：TAVILY_API_KEY / EXA_API_KEY / BRAVE_API_KEY

没有密钥的引擎会自动从 fan-out 中剔除。

免费层零配置。 Bing、DuckDuckGo、Yahoo 和 Exa MCP（exa-free）都无需密钥，并行运行。Antigravity CLI（agy）是可选组件，只有安装并登录后，才会加入 api 层（medium/complex 档位）。

x_search 凭据（可选）

| 命令 | 作用 |
| /x-login | 导入 grok 登录 → 官方托管的 x_search 路径（SuperGrok / X Premium+ 档位） |
| /x-login -k <XAI_API_KEY> | 同上，改用 console.x.ai API key |
| /x-login status | 显示凭据链 |
| /x-logout | 停用官方路径；回退链仍然可用 |

~/.grok/auth.json 永远不会被自动读取。没有 /x-login 或 XAI_API_KEY 时，x_search 只用免凭据链。

实测基准（2026-08，Windows）

免费层引擎探测（12 条查询 × 9 个候选）

实时基准（node scripts/engine-benchmark.mjs）；完整报告见 scripts/engine-benchmark-report.json。

| 引擎 | 成功率 | 平均延迟 | 结论 |
| bing | 100% | ~2.0s | ✅ 免费层 |
| ddg | 100% | ~2.2s | ✅ 免费层 |
| yahoo | 100% | ~2.3s | ✅ 免费层（v0.1.2 新增） |
| exa-free | 100% | ~4.2s | ✅ 免费层 |
| antigravity | 92% | ~27s | 仅 api 层（慢，需要 agy CLI） |
| brave-html / mojeek / searx | 0% | — | 已淘汰（429、被封或无法访问） |

集成场景

| 场景 | 结果 |
| free 层 fused_search | ~1.3–3.0s 内 5 条命中；跨引擎互证（例如 yahoo+exa-free 在 rust release notes 上得分 3.29） |
| x_search（无凭据） | 关键词走多引擎 + oEmbed；用户走 guest GraphQL（@NASA ~2s）；线程走 oEmbed |
| SSRF 对 Clash TUN fake-ip | 字面量 198.18/15 被拦截；TUN 路由的主机名放行（DSH_SEARCH_ALLOW_TUN_FAKEIP=0 可关闭） |
| 无头 web_search | ✓ 免费 Bing/DDG/Yahoo/Exa 链 |
| 单元 + E2E 测试 | 57/57 单元测试；14/14 黑盒 E2E |

架构说明

- 运行在宿主进程中（直接调用 Node fetch / child_process）。
- HTML 抓取器（Bing / DDG / Yahoo）使用 IPv4 强制 fetch —— Windows 上的 undici 默认 IPv6 优先 DNS，对搜索主机会间歇性超时。
- X 搜索：官方路径（lib/xsearch.js）→ 免凭据链（lib/xfallback.js：多引擎 + oEmbed + guest GraphQL），无凭据时做同步预检。

文件

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 — 主动搜索策略 cordis.patch.yml — DSH 补丁层清单 scripts/engine-benchmark.mjs — 维护者用：实时免费引擎探测

发布（维护者） sh
npm test
npm publish # prepublishOnly: syntax + tests + clean git tree

许可证

MIT

链接： Issues · search-boost · pi-search-boost

友情链接： LINUX DO 社区