dsh-search-boost:为 DSH 升级多引擎搜索与深度研究

前言

在 DeepSeek Harness(DSH)里跑智能体,联网检索往往是瓶颈:内置 web_search / web_fetch 能力有限,单引擎结果不稳定,时效性强的信息容易漏检;要查 X(Twitter)内容,还得自己拼接口或写降级逻辑。社区里也有独立的搜索 MCP,但和 DSH 的内置工具链、引用卡片并不天然对齐。

下面介绍 dsh-search-boost——由维护者 Mr-remon219 发布的 DSH bundle 插件(GitHub 12 stars,SkillHub 分类:模型推理)。它以 npm 包形式接入,升级内置搜索与抓取后端,并注册融合检索、X 搜索、深度研究等一整套工具,同时保留 DSH 原生的引用展示方式。

这是什么

dsh-search-boost 是面向 DeepSeek Harness 的 bundle 插件(当前版本 0.1.3,MIT 许可)。它通过 cordis.patch.yml 自动 patch DSH 配置:注册 WebSearchProviderWebFetchProvider,让内置 web_search / web_fetch 的 UI 与引用卡片不变,后端改走插件的多引擎链路与 Jina 优先的页面读取。

插件同时暴露 fused_searchx_searchfetch_pagedeep_researchresearch_parallel 等独立工具,并在 systemPrompt.section 注入主动搜索守则(例如时效事实需检索、X 内容走 x_search)。

该插件属于 Mr-remon219 的 search-boost 系列中与 DSH 对应的发行版;同系列还有面向 Cursor / MCP 的 search-boost 与面向 pi 的 pi-search-boost

核心功能

双搜索层:free 与 api

运行时用 /web_change 切换搜索层,选择持久化到 ~/.dsh-search-boost-layer.json

调用的引擎 适用场景
free Bing、DuckDuckGo、Yahoo、Exa MCP(exa-free),全部无 API key,并行探活 反复研究、零成本、不想消耗付费额度
api(默认) 上述无 key 引擎,加上本机可用的 Antigravity CLI(agy),以及已配置 key 的 Tavily / Brave / Exa 需要更高召回、愿意使用付费 API

无 key 引擎并行运行,单个失败不会导致整次检索空手而归。融合排序包含跨引擎共现加分与半衰期时效衰减。维护者在 2026-08 的基准测试中,free 层 Bing / DDG / Yahoo / exa-free 成功率均为 100%,fused_search 约 1.3–3.0s 返回 5 条结果。

常用切换命令:

/web_change free    # 仅无 key 引擎池
/web_change api     # 完整引擎池(默认)
/web_change show    # 查看当前层与各引擎可用性

内置工具升级

插件 patch 后,DSH 原有的 web_searchweb_fetch 调用方式不变,后端替换为插件引擎链与 Jina Reader 优先的抓取逻辑。对现有工作流来说,这是最低迁移成本的接入路径。

fused_search 提供复杂度分档、Grok 风格查询预处理(site:OR、引号)、域名过滤、跨引擎打分与 6 小时 TTL 缓存。搜索层由 /web_change 控制,单次调用也可通过 layer 参数覆盖。

x_search:X / Twitter 实时检索

x_search 支持帖文、用户、线程检索:

  • 有凭据(通过 /x-login 导入):托管 xAI 工具与多引擎(限 site:x.com)并行,结果合并去重。
  • 无凭据:多引擎 + oEmbed 全文(约 2s)、guest GraphQL 用户资料、oEmbed 线程;维护者基准中无凭据路径可检索 @NASA 用户资料。

凭据管理:

/x-login                    # 从 ~/.grok/auth.json 导入
/x-login -k <XAI_API_KEY>   # 使用 console.x.ai API key
/x-login status             # 查看凭据链
/x-logout                   # 移除凭据,回退到免凭据链

~/.grok/auth.json 不会被自动读取;未执行 /x-login 且无 XAI_API_KEY 时,只走免凭据降级链。

页面抓取与研究工具

工具 作用
fetch_page Jina Reader + 本地 HTML 回退 + focus 定向提取 + 24h 缓存
deep_research step 模式深度研究:复杂融合检索、覆盖度分析、缺口识别、建议查询,由主 agent 多轮驱动
research_parallel 子查询分解 → DSH 原生 subagent 并行执行 → 来源合并
search_stats 缓存、分档、引擎可用性与 x_search 凭据审计

安装与启用

推荐通过 npm 以 bundle 方式安装。--profile web 为必填参数(web 是常用的 Web UI 配置档);DSH 通过 pnpm 拉包并自动应用 dsh.bundle.patch,无需手改配置文件。

dsh plugin --profile web add dsh-search-boost          # 安装最新版
dsh plugin --profile web add dsh-search-boost@0.1.3    # 指定版本
dsh plugin --profile web update dsh-search-boost       # 更新

安装完成后重启 DSH:

dsh --profile web

验证插件是否生效:

dsh --profile web --dump-config   # web.searchProvider 应为 dsh-search-boost

若本机没有全局 dsh 命令(例如只用 npx @deepseek-ai/dsh web 启动),可先全局安装,或直接用 npx 执行插件命令:

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

dsh plugin 依赖 pnpmnpm install -g pnpm 或通过 corepack 启用)。插件要求 Node >= 22.13。

从源码安装(开发场景):

dsh plugin --profile web add github:Mr-remon219/dsh-search-boost

Linux / macOS 也可使用仓库内 ./install.sh(Windows 为 .\install.ps1),脚本会依次做语法检查、key 配置提示、安装与验证。

典型用法

零配置起步(free 层)

free 层不需要 API key。安装并重启后,直接在 DSH 对话中让 agent 检索即可——内置 web_search 已走 Bing / DDG / Yahoo / Exa-free 并行链。若要显式限制成本,先切换层:

/web_change free
/web_change show

配置付费 API(api 层)

发布包不含密钥。在 ~/.dsh-search-boost-keys.json 或项目目录 ./.search-boost-keys.json 中写入:

{ "tavily": "tvly-...", "exa": "...", "brave": "..." }

也可通过环境变量 TAVILY_API_KEYEXA_API_KEYBRAVE_API_KEY 提供。缺 key 的引擎会自动从并行列表剔除;配一个 key 即可工作,文档建议配齐三个以获得最佳融合效果。

切换回完整引擎池:

/web_change api

深度研究与并行调研

在对话中让 agent 调用 deep_research 做分步深研,或调用 research_parallel 将复杂问题拆成子查询后并行检索再合并来源。search_stats 可查看当前缓存、引擎分档与 x_search 凭据状态。

适用场景与注意

适合谁:

  • 在 DSH 中频繁做联网调研、需要比单引擎更稳定召回的开发者。
  • 希望保留内置 web_search / web_fetch 引用卡片,又想要多引擎融合、X 搜索、深度研究能力的团队。
  • 想先用 free 层零成本验证,再按需接入 Tavily / Brave / Exa 等付费 API 的用户。

使用前请注意:

  • 插件以 当前 dsh 进程的权限 运行,会发起外部 HTTP 请求、读取本地凭据文件(如 ~/.dsh-search-boost-keys.json)。安装前应阅读源码与 MIT 许可证,确认网络出口与密钥存放策略符合你的环境要求。
  • SkillHub(目录页)是社区插件目录,与 DeepSeek / 幻方无官方从属关系;DSH 本身遵循「一切皆插件」理念,具体能力以所选插件为准。
  • 仓库还提供会话级动态插件 plugin-host.js,适合单次会话试用,不替换内置 web_search;部署级集成仍推荐上面的 bundle 方式。
  • 维护者记录了 SSRF 防护行为:字面量 198.18.0.0/15 会被拦截;使用 Clash TUN fake-ip 时可通过 DSH_SEARCH_ALLOW_TUN_FAKEIP=0 关闭相关放行。

结尾

dsh-search-boost 把多引擎融合搜索、页面抓取、X 检索与深度研究封装成 DSH 可直接消费的 bundle 插件,并用 /web_change 在零成本 free 层与完整 api 层之间切换。若你正在 DSH 里做需要稳定联网能力的智能体开发,可以按本文步骤安装验证。

  • SkillHub 目录页:https://www.skillhub.cn/plugins/Mr-remon219/dsh-search-boost
  • GitHub 仓库:https://github.com/Mr-remon219/dsh-search-boost
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜