前言¶
在 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 配置:注册 WebSearchProvider 与 WebFetchProvider,让内置 web_search / web_fetch 的 UI 与引用卡片不变,后端改走插件的多引擎链路与 Jina 优先的页面读取。
插件同时暴露 fused_search、x_search、fetch_page、deep_research、research_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_search 与 web_fetch 调用方式不变,后端替换为插件引擎链与 Jina Reader 优先的抓取逻辑。对现有工作流来说,这是最低迁移成本的接入路径。
fused_search:多引擎融合检索¶
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 依赖 pnpm(npm 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_KEY、EXA_API_KEY、BRAVE_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