一个搜索 · dsh-onesearch

DeepSeek Harness 的搜索插件：把内置的网络搜索换成一条可排序的搜索引擎链——每个引擎单独开关，拖动决定谁先谁后，前一个失败或没搜到东西就自动改用下一个。

适用于 DeepSeek Harness 0.2.1-rc.2。

它解决什么

Harness 的内置搜索只认一个搜索服务。那个服务一报错（额度用完、被限流、网络抖动），web_search 就整次失败，模型只能空手回答。

一个搜索在中间加了一条链：按你定的顺序依次去问，一个不行就换下一个；只有全都失败时才报错，并说清每个引擎各自为什么失败。

• 顺序就是优先级，设置页里拖动排序，第 1 位最先被问
• 每个引擎一个开关，关掉的直接跳过
• 单个引擎失败不影响结果，只在全链失败时汇总报错
• 没配 key 的引擎自动跳过，不会占在队首空转
• 模型侧工具没有变化，仍然是 web_search / web_fetch，工具名里不出现任何搜索引擎的名字

快速开始

1. 在 DeepSeek Harness 中打开 插件管理，点击 添加插件。

2. 在“输入插件的包名、GitHub 仓库地址或本地目录路径”输入框中，填写下面任意一种：

   npm 包名（推荐）：

   dsh-onesearch
   

   GitHub 仓库地址：

   https://github.com/jeweis/dsh-onesearch
   

3. 点击 安装，然后在 已安装插件 中打开 一个搜索 右侧的启用开关。刚发布的版本若在镜像源找不到，可在安装源里切换到 npm 官方源。

4. 装完就能用：默认引擎链是 元宝搜索 → 豆包搜索 → Bing 网页，其中 Bing 免密钥，不配置任何 API KEY 也能搜索。

在哪里使用

安装并启用后，进入 设置 → 插件，找到 一个搜索 这一行，点击行内的 配置，页面分三块：

区块	作用
引擎优先级	拖动左侧 ⠿ 把手调整顺序，右侧开关单独启停。改完立即生效，不用重启插件
API KEY	需要 key 的引擎各一张卡。密码框写入、写入后不再回显，只显示“已配置 / 缺少 API KEY”
默认搜索	是否让 web_search 走这条链。关掉即交还给其他搜索服务

无需编辑 YAML。KEY 也可以改用环境变量（见 配置文档）。

引擎

id	名称	需要 key	说明
yuanbao	元宝搜索	✅ sk-…	腾讯 WSA，中文优先，支持站点/时效/垂域过滤
doubao	豆包搜索	✅	火山引擎联网搜索，中文与资讯覆盖好、响应快；支持站点过滤，不读时间区间
bing-html	Bing 网页	❌	免密钥兜底，防止主引擎挂掉时整个搜索失败

带过滤条件时，支持该过滤的引擎会排到前面先跑；不支持的引擎不会直接丢掉，而是排到后面作为降级选项——宁可比要求宽一点，也不空手而归。

用通用操作符表达过滤

站点和时间过滤不另开工具，直接用搜索框都懂的操作符，由支持的引擎翻译：

写法	含义	元宝	豆包
site:cloud.tencent.com 关键词	只搜这个域	✅	✅
关键词 -site:csdn.net -site:zhihu.com	排除域名（最多 5 个）	✅	—
关键词 after:2026-01-01	该日期之后	✅	—
关键词 before:2026-06-30	该日期之前	✅	—

after / before 可以只写一个。Bing 引擎拿到的是原始查询（它自己也认这些操作符）。

和其他搜索插件的关系

• 一个搜索只接管 web_search 这一个入口。其他搜索插件提供的工具（如 advanced_search）照常可用，但它们内部仍走自己的引擎。
• 与 dsh-free-search、ds-bot 的自带搜索不冲突：同一时刻只有一个搜索服务在为 web_search 作答，由 默认搜索 开关决定。
• 想切回去：设置页关掉 默认搜索；或把 cordis.patch.yml 里 - id: web 的 searchProvider 改回去。

文档

• 配置项与排障
• 内部机制
• 开发与新增引擎
• 发布流程

许可

MIT