多引擎搜索插件 u9521/dsh-cust-search

dsh-cust-search

DeepSeek Harness (DSH) WebUI 多引擎顺序搜索插件，按顺序尝试多个搜索引擎，当前引擎搜不到或报错时自动换下一个。

界面预览

1. 配置界面

配置界面

2. 排序模式

排序模式

3. 搜索测试

搜索测试

核心特性

- 多引擎按顺序搜索：搜索时按排好的顺序依次尝试。如果前面的引擎遇到网络问题、Key 失效或超时，会自动换下一个已开启的引擎接着搜，直到搜出结果为止。
- 支持 11 款搜索引擎：内置 DeepSeek 官方直连、免费网页搜索（Bing、DuckDuckGo、SearXNG）以及 AI 智能搜索（Tavily、Exa、Firecrawl、Parallel、Perplexity 等）。

支持的搜索引擎

| 引擎名称 | 引擎 ID | 接入类型 | 凭据配置 | 说明 |
| DeepSeek Official | deepseek | Bridge | 官方插件设置页 | 桥接官方提供方：优先 deepseek-search-api（直连 Search API），回退 deepseek-official（Messages web_search） |
| Bing | bing | Free | 无需凭据 | 语言区域驱动网页检索 |
| DuckDuckGo | ddg | Free | 无需凭据 | HTML 主通道，失败降级 Lite 通道 |
| SearXNG | searxng | Free | 无需凭据 | 自动轮询公共实例，支持配置自定义实例 |
| Tavily | tavily | Keyed | TAVILY_API_KEY | 有 Key 走高质量接口，无 Key 走共享通道 |
| AnySearch | anysearch | Free | 无需凭据 | 免费免 Key 结构化 AI 搜索 |
| Exa | exa | Keyed | EXA_API_KEY | 神经语义搜索，有 Key 走 REST，无 Key 走公共 MCP |
| Keenable | keenable | Keyed | KEENABLE_API_KEY | 实时网络检索，有 Key 走 REST，无 Key 走免 Key MCP |
| Firecrawl | firecrawl | Keyed | FIRECRAWL_API_KEY | 深度网页抓取与解析，支持免 Key 匿名配额 |
| Parallel | parallel | Keyed | PARALLEL_API_KEY | AI 目标检索，无 Key 走免认证 Streamable HTTP MCP |
| Perplexity | perplexity | Keyed | PERPLEXITY_API_KEY | Sonar 大模型生成式检索，带引用来源 |

deepseek 直连引擎复用官方 DeepSeek 提供方。DSH 0.2.1-rc.2 提供两个：deepseek-search-api（单次直连 Search API 请求，不产生模型调用，可指定结果数）与 deepseek-official（一次 Messages 调用，走原生 web_search 服务端工具）。引擎优先用直连 API，回退到 Messages 搜索；只有当另一个提供方自报可用时才会跳过不可用者——两者都没配 Key 时仍会选中一个，以便报出「缺少哪个 Key」而不是「什么都没注册」。@deepseek-ai/dsh-web 未公开「按 ID 取 provider」的接口，因此该引擎直接读取 web 运行时的 provider 注册表（收敛在 src/server/engines/deepseek.ts 一处）；若该内部结构变化，引擎会降级为「不可用」而不是让整个搜索失败。

DSH 版本兼容性

| 插件版本 | 兼容 DSH 版本 | 说明 |
| main（当前） | >= 0.2.1-rc.2 | 桥接两个官方 DeepSeek 提供方（优先 deepseek-search-api）；使用类型化 ctx.slots、credentials.describe() 判断密钥状态、ctx.storage.domain 持久化配置；由 cordis.patch.yml 声明式固定 web.searchProvider |

快速安装 (推荐 / 一行命令)

通过 GitHub dist 分支安装（由 CI 自动构建产物，无需本地编译）：

dsh plugin --profile web add github:u9521/dsh-cust-search#dist

安装后重启 web（dsh web）并硬刷新浏览器（Cmd+Shift+R 或 Ctrl+F5）。配置页在插件自己的卡片上：插件 → 已安装 → @local/dsh-cust-search。

升级

通过 dsh plugin update 命令拉取最新发布版本：

dsh plugin --profile web update @local/dsh-cust-search

升级后重启 web 并硬刷新浏览器。

配置与存储

配置保存于独立的用户存储文件中，不修改系统配置文件：

- 存储路径：~/.dsh/storages/cust_search.json（ctx.storage.domain 的 unit 文档：{ "unit": {...}, "global": {...}, "tables": {} }）
- 详细规范：完整的配置格式与字段定义，请参阅 存储结构与 JSON Schema 规范。

本地开发与源码构建

环境要求

- pnpm：npm install -g pnpm
- Node.js：^22.19 || >=24

1. 克隆与构建

git clone https://github.com/u9521/dsh-cust-search.git ~/.dsh/plugins/dsh-cust-search
cd ~/.dsh/plugins/dsh-cust-search
pnpm install
pnpm run build

2. 本地安装

dsh plugin --profile web add ~/.dsh/plugins/dsh-cust-search

安装后重启 web（dsh web）并硬刷新浏览器。

3. 本地源码升级

本地安装以软链接方式接入 profile，源码升级仅需拉取最新代码并重新构建：

cd ~/.dsh/plugins/dsh-cust-search
git pull
pnpm run build

常用开发命令

| 命令 | 说明 |
| pnpm run build | 完整编译构建（tsc 类型检查后生成 lib/ 产物；若宿主产物内联了宿主已提供的包则构建失败） |
| pnpm run check | 仅类型检查 (tsc --noEmit) |
| pnpm run lint | 全量代码检查 (ESLint + TypeScript + Prettier) |
| pnpm run lint:fix | 自动修复 ESLint 规则与代码格式化 |
| pnpm run fmt | 用 Prettier 格式化源码与配置文件 |

卸载

dsh plugin --profile web remove @local/dsh-cust-search

卸载后重启 web 并硬刷新浏览器。若本地不再需要源码，可删除克隆目录：

rm -rf ~/.dsh/plugins/dsh-cust-search

许可证

MIT © 2026 u9521