dsh-search-fusion
Manifest validMulti-engine search fusion for DeepSeek Harness: lazy fusion, fallback, query cache, custom JSON/MCP engines (Tavily preset).
dsh-search-fusion
多引擎搜索融合 · 能省则省,需要时才融合
DeepSeek Harness 的搜索插件。把 Bing / DuckDuckGo / SearXNG 等多个后端统一包装成一个 ctx.web search provider(fusion),并提供按需融合与查询缓存——因为免费引擎的额度是有限资源。
和 dsh-search-router 的区别
| dsh-search-router | dsh-search-fusion | |
|---|---|---|
| 多引擎配置 | ✅ | ✅ |
| 失败自动 fallback | ✅ | ✅ |
| 部分结果合并 | ❌ 前一个引擎的结果被丢弃 | ✅ 合并去重、跨引擎一致性加权 |
| 按需融合 | ❌ | ✅ 默认只在结果不足时才多查 |
| 查询缓存 | ❌ | ✅ 重复查询零请求 |
| 成本可见 | ❌ | ✅ 结果里说明查了几个引擎、几次命中缓存 |
| 动态切换 | ✅ 即时切换 | ✅ 工具切换 |
router 回答的是「用哪个引擎」;fusion 回答的是「怎么用最少的请求拿到够用的结果」。
成本模型(这是插件的核心)
免费引擎有额度,所以默认路径只发一个请求:
| 策略 | 行为 | 请求数 |
|---|---|---|
sequential | 依次尝试,第一个成功就停 | 1(成功时) |
fusion(默认) | 同上,但结果少于 minResults 或为空时才继续查 | 通常 1,不足时才 2+ |
always-fuse | 并行查完链路里所有引擎再合并 | N(显式 opt-in) |
外加查询缓存(默认 10 分钟):同一 query 的重复搜索零请求。
每次搜索的结果都带一行报告,写明实际开销:
Fusion: 2 engine(s) queried (bing, ddg); answered: bing, ddg.
Merged 12 unique sources, showing top 10.
Cross-engine agreement: 2 source(s) returned by 2+ engines.
Elapsed 812 ms.
融合的排序逻辑
score = 引擎权重 + 跨引擎一致性×1.5 + 有标题 + 有摘要
跨引擎一致性是这里唯一有意思的项:同一个 URL 被两个独立引擎都返回,比只被一个引擎返回更可能是真答案。权重设成能压过略重的引擎,但不会让单个引擎的头条被埋掉。
URL 去重会规范化:去掉 #fragment、尾部 /、utm_* 等追踪参数,域名小写、路径保持大小写敏感。
安装
dsh plugin --profile desktop add dsh-search-fusion
或在 profile 的 package.json 里:
{
"dependencies": { "dsh-search-fusion": "link:C:/Data/Project/dsh-forks/dsh-search-fusion" },
"dsh": { "profile": { "bundles": [ /* …, */ "dsh-search-fusion" ] } }
}
装完重启 DSH。
使用 link: 开发时,插件目录通常在 profile 之外。Node ESM 按 realpath 解析裸包名,因此不能静态 import 宿主私有包 @deepseek-ai/*:即使宿主能使用这些服务,插件目录也未必能解析它们。本插件采用零宿主静态依赖、纯对象工具定义,以及 ctx.get() 动态获取凭据等能力。改回静态 import 会导致模块加载失败,进而出现 configured web provider "fusion" is not registered。
验证是否生效
重启 DSH 后:
- 设置 → 左侧导航 → 搜索融合 应出现独立入口(由 client 半端的
settings.section注册); - 页面上改配置、点「+ 添加引擎」加一条自定义引擎并保存;
search_fusion_status工具应显示custom engines:列出新引擎;- 调用
web_search的结果应带Fusion: ...报告行。
search_fusion_switch 可切换主引擎和回退链,下一次搜索立即生效;自定义引擎的 id 也会出现在它的可用列表里。
设置页在哪
设置 → 侧边导航 → 搜索融合(本插件注册的独立设置页)。
本插件带 client 半端(lib/client.js,dsh.client 声明),通过宿主的 settings.section slot 注册一个真正的设置页,因此它会像「通用设置」「模型」「内置插件」一样出现在设置左侧导航里——而不是只落在「内置插件」页那张只读的 plugins.bundle.config 展示区(那里点不动,是宿主的插件清单卡片,不是配置表单)。
页面上可以直接改主引擎、回退链、策略、结果数、代理,以及增删自定义搜索引擎。数据经由 host 半端的 /plugins/dsh-search-fusion/config 路由读写。
保存后立即生效(下一次搜索就用新引擎链,不用重启):host 把值合并进 profile 的
cordis.patch.yml,同时替换内存里的引擎注册表。密钥轮换同样不需要重启。
保存后存在哪(为什么重启不会丢)
一次保存写两个地方:
| 位置 | 作用 |
|---|---|
<profile>/cordis.patch.yml | 宿主读取的权威配置 |
<profile>/dsh-search-fusion.state.json | 插件的本地恢复副本(最近一次成功保存的拷贝) |
cordis.patch.yml 本身并不可靠:桌面端崩溃后的救援对话框(「禁用第三方插件、备份 profile patch 并重启」)会把它改名,重新生成的 profile 一开始也是空 patch——这些都会把自定义引擎一起清掉,表现出来就是「重启后我加的引擎又没了」。所以插件每次都把同一份字段写进 state.json,并在启动时比对:
- profile 里的引擎没了、或者少了几行 → 用恢复副本补回来,设置页顶部显示橙色提示「检测到 profile 配置里缺少:自定义搜索引擎…」;
- 打开设置页时会把恢复后的值自动写回 profile patch,点一次「保存」就彻底落盘;
- 只有「profile 里的值还是默认值」才会恢复,你手动改过的值不会被副本覆盖;
- 你在页面里把引擎删光并保存 → 副本也跟着变空,下次启动不会又冒出来。
想彻底清空:删掉 dsh-search-fusion.state.json 再保存一次,或者保存空列表。
保存会被拒绝而不是静默丢行
填错的引擎行(id 不合法、和内置引擎重名、id 重复、URL 不是 http(s)、主引擎/回退链引用了不存在的 id、数字超范围)会让整次保存失败,请求返回 400,页面上逐条列出原因,profile、凭据、恢复副本都不会被改动。
旧行为是坏行静默丢弃、其余照写——页面提示「已保存」,重启后引擎却不在,和丢数据无法区分。现在宁可报错也不假装成功。
自定义搜索引擎(填地址 + Key 就行)
内置引擎只有无需配置 Key 的 Bing、DuckDuckGo、DuckDuckGo Lite 和 SearXNG。AnySearch 是可添加引擎:粘贴 https://api.anysearch.com/v1/search 后会自动套用预设;在该卡片的 Key 输入框粘贴密钥,保存时它会作为 DSH 凭据存到 ANYSEARCH_API_KEY。
设置页里点 「+ 添加引擎」,然后:
- 粘贴 API 地址 —— 引擎名和全部技术参数自动跟着地址走
- 粘贴 API Key —— 保存时写进 DSH 凭据
没有「引擎类型」这种下拉。地址就是身份:粘 https://api.tavily.com/search 就自动叫 Tavily,并自动填好 POST、Authorization: Bearer、请求体 {query, max_results}、结果取 results[].{url,title,content};粘任意别的域名,就用域名当名字(search.acme.io → Acme)。
名字可以改:卡片顶部就是名称输入框,直接改;改过之后它就不再跟着地址变了(只填过地址、名字还是自动的,才会随地址更新)。这也顺带解决了一个实际需求——同一个 Tavily 换个网关地址,名字还叫 Tavily 就行。
自动识别的依据
匹配只看主机名,不看路径:
| 地址 | 识别结果 |
|---|---|
api.tavily.com(含 eu.api.tavily.com 等子域) | Tavily(REST 预设) |
mcp.tavily.com | Tavily(MCP 预设) |
api.anysearch.com | AnySearch(REST 预设) |
| 其它域名 | 取域名主体首字母大写,如 Acme |
识别到预设时会同时补上 apiKeyEnv;该引用被别的行占用时不会抢,而是留空、由保存时按 id 派生。
MCP
地址含 /mcp/ 或命中 mcp.tavily.com 时按 MCP 协议走:
initialize -> 拿 protocolVersion + mcp-session-id
notifications/initialized
tools/call -> { name: "tavily_search", arguments: { query, max_results } }
响应支持 JSON 和 SSE(text/event-stream)两种帧;工具返回的文本若本身是 JSON,就用和 REST 完全相同的 resultsPath / 字段映射解析,两种传输共用一条结果管线。会话一次性(每次搜索新开、用完即丢),换 Key 立即生效。
API Key 存哪
Key 输入框是密码框,保存时前端把值放在 secrets: {<engine id>: <key>} 里发给 host,host 调用 DSH 凭据服务(ctx.get("credentials").set(ref, value))写入 ~/.dsh/.credentials.yaml,然后从 patch 里删掉明文——落进 profile 的 cordis.patch.yml 的只有引用名。
- 引用名优先用该行识别出的
apiKeyEnv;没有就自动派生(tavily→TAVILY_API_KEY,其它 id →DSH_SEARCH_<ID>_KEY)。 - 已保存的 Key 在页面上显示为一段掩码(
••••••••),不是空框——空框会让人以为 Key 丢了。掩码只是占位,不会被当成密钥回写;只有你重新输入的值才会被保存。 - 保存时若不重新输入,该引擎的 Key 保持不动(mask 不会被当作新值)。
- 没有 credentials 服务的环境会直接报错,而不是静默丢 Key。
搜索时解析顺序:ctx.get("credentials") → launchEnvironment → process.env。每次搜索重新解析,轮换 Key 无需重启;新增/删除引擎也在下一次搜索立即生效(见上文「保存后存在哪」)。
整体收起
引擎列表可以整体折叠:卡片多了以后页面会很长,标题栏右侧有「收起 / 展开」按钮,标题下面那行会直接给出摘要(如 2 个引擎:Tavily、Acme,缺 Key 的会标「缺 Key」)。
首次进入页面时,已有引擎就默认收起(配置一次之后就很少改);点「+ 添加引擎」会自动展开。
每张卡片可单独收起
每张卡片标题左侧有 ▾/▸ 折叠标记,点它只折叠这一张。收起后显示一行摘要(地址 · 已存 Key / MCP · 缺 Key)。
默认状态:从配置里读出来的卡片收起(已经配好了),本次新增的卡片展开(正在填)。编辑时会自动保持展开,不会在输入过程中突然收起。
MCP 用配置文件,不是填空
MCP 服务器都是按 mcpServers 片段分发的,所以这一行是个 JSON 文本域,直接粘贴整段即可:
{
"mcpServers": {
"tavily": {
"url": "https://mcp.tavily.com/mcp/"
}
}
}
支持几种写法:
| 粘贴内容 | 行为 |
|---|---|
mcpServers 片段 | 取第一个服务器的 url / name / headers |
{ "url": "..." } | 单个服务器,不包一层 |
| 直接粘到「API 地址」框 | 自动识别为 MCP,转成文本域 |
headers里的Authorization: Bearer xxx会转成Authorization: Bearer {key},真实 Key 仍由 Key 框存进凭据。command/args的 stdio 服务器不支持(本插件只走 HTTP/SSE),会给出提示而不是静默失败。- 粘贴后名称按地址自动识别(
mcp.tavily.com→Tavily (MCP)),id 撞号时自动避让成tavily-mcp。
可以加多个
- 每个引擎一行、一个 Key。
- 同类型多行不会复用同一个凭据引用,否则保存时会互相覆盖,会自动派生
DSH_SEARCH_<ID>_KEY。 - 卡片徽标标出它在链路里的身份:主引擎 / 回退 / 未启用;标「未启用」的行旁边有「加入回退链」按钮。
- 删除主引擎时主引擎自动顺延到下一个自定义引擎(没有则回到
bing)。
高级字段(一般不用改)
折叠在「高级」里:id、连接方式(REST/MCP)、方法、Key 引用、认证头模板、结果数组路径、URL/标题/摘要字段、请求体模板、MCP 工具名与参数名。这些值默认由地址识别得出,只有在源站返回格式特殊时才需要动。
等价 YAML(不用 GUI 时直接写 profile 的 cordis.patch.yml):
- id: dsh-search-fusion
config:
primary: tavily
fallback: [bing]
customEngines:
- id: tavily
preset: tavily # 其余技术字段由预设补齐
url: https://api.tavily.com/search
apiKeyEnv: TAVILY_API_KEY # 值放 DSH 凭据/环境变量,别写这里
保存 → 重启 DSH → search_fusion_status 的 custom engines: 一行应列出该引擎,search_fusion_switch 的可用引擎里也会出现它。
不用 GUI 也可以:直接在 profile 的 cordis.patch.yml 写 customEngines:(格式同上),或在插件自带的 cordis.patch.yml 的 config: 里写。临时切换用 search_fusion_switch 工具(重启后恢复持久配置)。
插件包自带的 patch 把 searchProvider 设为 fusion,同时必须把 fetchProvider: http 一起重写一遍——DSH 的 loader patch 是「整段替换 config」而不是合并,只写 searchProvider 会把 dsh-base 设的 fetchProvider: http 冲掉,导致 http 和 deepseek-fetch-api 两个 fetch provider 同时可用、web_fetch 直接报 WEB_PROVIDER_AMBIGUOUS(multiple usable web providers are registered)。
想用 DeepSeek 的 Fetch API(返回 Markdown、不受本地抓取的匿名限制)就在更高层覆盖,profile 或 ~/.dsh/cordis.patch.yml 的层序在后、会赢:
- id: web
config:
searchProvider: fusion
fetchProvider: deepseek-fetch-api
| 键 | 默认 | 说明 |
|---|---|---|
primary | bing | 首选引擎 |
fallback | ["ddg","searxng"] | 主引擎失败或结果不足时依次尝试 |
strategy | fusion | sequential / fusion / always-fuse |
maxResults | 10 | 最终保留的结果数 |
minResults | 5 | fusion 策略下,低于此数才继续查下一个引擎 |
cacheEnabled | true | 查询缓存开关 |
cacheTtlMs | 600000 | 缓存有效期 |
engineTimeoutMs | 12000 | 单引擎超时 |
locale | zh-CN | 传给支持地区参数的引擎 |
searxngInstances | [] | 自定义 SearXNG 实例,留空用内置顺序 |
customEngines | [] | 用户自定义 JSON 搜索引擎,见上节 |
engineWeights | {} | 手动调权,未列出的引擎权重为 1 |
代理(中国大陆必读)
DuckDuckGo 和 SextXNG 在本网络需要走代理才能访问;Bing 的 cn.bing.com 可直连。
Node 的全局 fetch 不读取 HTTP_PROXY / HTTPS_PROXY,所以插件自带了一个最小代理客户端(lib/proxy.js,走 HTTP CONNECT 隧道)。配置:
// ~/.dsh/settings.yaml
search-fusion:
proxy: "http://127.0.0.1:7897"
留空则直连(适合有直接出网能力的环境)。
工具
| 工具 | 用途 |
|---|---|
search_fusion_status | 当前引擎、回退链、策略、缓存统计、上次搜索结果 |
search_fusion_switch | 切换主引擎/回退链,下一次搜索即生效 |
开发
npm test # 离线测试(融合、解析器、provider、宿主加载契约、恢复副本、自定义引擎本地 HTTP 端到端)
npm run check # 语法检查 + 离线测试
npm run test:live -- <proxy?> # 真实引擎冒烟(需要网络/代理)
npm run test:proxy -- http://127.0.0.1:7897 # 代理客户端 + 全引擎验证
npm run fixtures -- <proxy?> # 重新抓取 HTML 夹具
测试夹具
tests/fixtures/*.html 是从真实引擎抓下来的响应原文。解析器测试跑在这些真实字节上,因为手写的示例 HTML 会漏掉真实世界的坑——已经踩中三个:
- DuckDuckGo 的结果容器是多个 class(
"result results_links results_links_deep web-result"),锚定class="result"会静默解析出 0 条; - DuckDuckGo Lite 用单引号属性,而且
href在class之前; - Bing 的
www.bing.com会 302 到cn.bing.com。
一个已知的静默失败
DuckDuckGo 的 HTML 端点如果在 URL 和 POST body 里都给 q,它不报错,而是返回一个空结果页。0 结果而不是错误——排查时注意。
兼容性
- DSH
>=0.2.1-rc.1 <0.3.0-0 - Node
^22.19.0 || >=24.0.0 - 宿主包均为 optional peer,无静态宿主依赖;schemastery 与 dsh-web 仅动态尝试加载,缺失时降级。
License
MIT
Comments
Loading…
Similar plugins
by u9521
Custom Web Search plugin for DeepSeek Harness (DSH), replacing web-search-deepseek with multi-engine sequential fallback.
★ 0
MIT
TypeScript
Oct 17, 2026
dsh plugin --profile web add @local/dsh-cust-searchby nitrazepam01
Tavily-backed web search provider bundle for DeepSeek Harness (dsh) with hot-switchable backend (Tavily / DeepSeek search)
★ 3
↓ 179/wk
MIT
JavaScript
Aug 14, 2026
dsh plugin --profile web add dsh-web-search-tavilyby qunqin24
Multi-engine web search plugin for DeepSeek Harness: free AI search rotation with cooldown, Tavily/Brave/Serper/Exa/Perplexity/Jina/Bocha/SearXNG, settings page.
★ 0
MIT
TypeScript
Oct 19, 2026
dsh plugin --profile web add dsh-plugin-search-hubby a2042798096-debug
DeepSeek 搜索:DeepSeek Harness 多引擎网页搜索、正文抓取与深度资料收集插件
★ 0
MIT
JavaScript
Oct 19, 2026
dsh plugin --profile web add dsh-deepseek-searchby tianmingwan
Balanced web search plugin/MCP server for DeepSeek Harness: Keenable / Exa / Tavily round-robin with failover. / 均衡搜索插件:Keenable / Exa / Tavily 轮流调用,自动故障切换。
★ 5
MIT
JavaScript
Oct 22, 2026
dsh plugin --profile web add dsh-balanced-searchby guyuefangyuanl
Cross-session persistent memory for the DeepSeek Harness: a model-facing memory tool, an always-on index section, and a bundled maintenance skill.
★ 3
↓ 1.5k/wk
MIT
JavaScript
Aug 21, 2026
dsh plugin --profile web add dsh-memory