前言¶

在 DeepSeek Harness（DSH）里给智能体接入 Web 搜索时，常见的问题是：不同搜索引擎的接入方式不同，免 Key 引擎与 API Key 引擎混在一起，配置、回退和持久化逻辑也容易分散。dsh-web-search-multi 把这些需求收敛到一个 DSH 插件里：提供多提供商 Web 搜索、DuckDuckGo 全局回退，以及 DSH Web UI 中的 Web Settings UI。

这是什么¶

dsh-web-search-multi 是面向 DeepSeek Harness 的多提供商 Web 搜索插件，由 cinob 维护，采用 MIT License。它支持 360、Bing、Baidu 等免费免 Key 直连引擎，也支持 Tavily、Brave Search、Serper/Google、Bocha AI、SearXNG 等提供商，并提供 DuckDuckGo 全局回退与 DSH Web UI 设置页。

核心能力¶

• 免费免 Key 直连：360、Bing、Baidu。
• 免费额度提供商：Tavily（1,000/月）、Brave Search（2,000/月）、Serper/Google（2,500 次）、Bocha AI。
• SearXNG：支持私有/自托管实例，并支持 token 认证；SEARXNG_TOKEN 为可选配置。
• 回退：DuckDuckGo 全局回退。
• Web GUI：在 DSH Web UI 中提供 Settings -> 多源 Web 搜索 设置页，支持实时连接测试和即时持久化。
• 凭据存储：秘密保存到 ~/.dsh/.credentials.yaml（mode 0600），非密钥设置保存到 ~/.dsh/settings.yaml。
• 权限与风险：风险等级为 low；网络权限是向所选搜索提供商发起出站 HTTPS 请求。
• 兼容要求：Node.js >=20.0.0、DeepSeek Harness mainline v0.1.0+、Linux/macOS/Windows。

安装与启用¶

下面先执行安装命令。该插件以 Profile Bundle 形式安装，内置 cordis.patch.yml 会自动挂载并激活 multi-search，无需手动插入 web-search-multi。

dsh plugin --profile web add github:cinob/dsh-web-search-multi

如果之后需要移除，执行卸载命令：

dsh plugin --profile web remove dsh-web-search-multi

典型用法¶

下面介绍在 DSH Web 中启用和配置搜索源。先启动 Web 服务：

dsh web

然后打开 http://127.0.0.1:3080，进入 Settings -> 多源 Web 搜索。

1、选择搜索引擎，或者保持 自动策略 (Auto)。
2、如果需要调用免费额度提供商，可选填入 TAVILY_API_KEY、BRAVE_API_KEY、SERPER_API_KEY、BOCHA_API_KEY 或 SEARXNG_TOKEN。
3、保存并进行实时测试。

适用场景与注意¶

适合以下情况：

• 希望先使用 360、Bing、Baidu 等免 Key 直连引擎。
• 已经使用 Tavily、Brave Search、Serper/Google 或 Bocha AI 的免费额度。
• 需要接入私有/自托管 SearXNG。
• 希望通过 DSH Web UI 维护搜索源、凭据和连接状态。

注意：

• 插件会向所选搜索提供商发起出站 HTTPS 请求。
• API Key 等秘密会保存到 ~/.dsh/.credentials.yaml（mode 0600），普通设置保存到 ~/.dsh/settings.yaml。
• 插件运行在 dsh 进程上下文中，并以当前 dsh 进程权限执行；安装前建议检查源码与 MIT License。
• 使用前确认环境满足 Node.js >=20.0.0 与 DeepSeek Harness mainline v0.1.0+，平台为 Linux/macOS/Windows。

结尾¶

dsh-web-search-multi 的价值在于把多提供商 Web 搜索、回退逻辑和 Web 设置页合并到 DSH 插件体系中，减少搜索源接入、配置和测试之间的切换成本。项目仓库地址：https://github.com/cinob/dsh-web-search-multi。