dsh-web-search-multi

维护状态: 活跃

cinob/dsh-web-search-multi

多源网络搜索插件：零配置必应/百度直搜，支持 Tavily/Brave/Serper/Bocha 免费额度与 SearXNG，自动降级。

前往 GitHub

$ dsh plugin add dsh-web-search-multi

安装

dsh 没有统一的安装命令——把该插件 README（见下方）中的配置行加入你的 profile/patch 配置，然后重启即可。

了解安装方式

星标

Fork

JavaScript

语言

MIT

许可证

2026-08-15

创建于

2026-08-26

README

dsh-web-search-multi

Multi-provider web search plugin for DeepSeek Harness (DSH) supporting free-tier providers (360, Bing, Baidu, Tavily, Brave, Serper, Bocha, SearXNG, DuckDuckGo) with auto-fallback and Web Settings UI.

English | 简体中文

1. Overview

dsh-web-search-multi connects DeepSeek Harness to multiple search engines with automated fault tolerance:

Free Zero-Key Direct Engines: 360 Search (real-time news and trending events), Bing, and Baidu direct search without any API keys.
AI-Native Free Tiers: Tavily (1,000/mo), Brave Search (2,000/mo), Serper/Google (2,500 free), Bocha AI.
Private & Self-Hosted: SearXNG with token authentication.
Global Fallback: DuckDuckGo.
Web GUI Control: Full graphical settings tab inside DSH Web UI (Settings -> 多源 Web 搜索) with live connection testing and instant persistence.
Secure Credential Storage: Secrets saved securely to ~/.dsh/.credentials.yaml (mode 0600), non-secret settings saved to ~/.dsh/settings.yaml.

2. Compatibility

Node.js: >= 20.0.0
DeepSeek Harness: Verified on mainline v0.1.0+
Platform: Linux / macOS / Windows

3. Install

As a standard DSH Profile Bundle, installation is one simple command:

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

Note: As a Profile Bundle, the plugin's built-in cordis.patch.yml automatically mounts and activates multi-search. There is no need to manually insert web-search-multi in profiles/web/cordis.patch.yml.

Uninstallation

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

4. Quick Start

Start DSH Web:
```
dsh web
```
Open Web GUI (http://127.0.0.1:3080) -> Click Settings (Gear icon) -> Select 多源 Web 搜索 in the sidebar.
Choose your preferred search engine or leave it on 自动策略 (Auto).
(Optional) Enter your API keys for Tavily, Brave, Serper, Bocha, or SearXNG Token, click Save, and test in real time.

5. Configuration

Credentials & Environment Mapping

Key / Variable	Description
`TAVILY_API_KEY`	Tavily API Key (1,000 searches/mo)
`BRAVE_API_KEY`	Brave Search API Key (2,000 searches/mo)
`SERPER_API_KEY`	Serper Google API Key (2,500 searches)
`BOCHA_API_KEY`	Bocha AI Search API Key
`SEARXNG_URL`	SearXNG instance URL (e.g. `https://s.655443.xyz`)
`SEARXNG_TOKEN`	SearXNG access token (optional)

6. Permissions & Data Disclosures

Risk Level: low
Network: Outbound HTTPS requests to selected search providers.
Credentials: Secrets persist securely in ~/.dsh/.credentials.yaml via ctx.credentials, general settings in ~/.dsh/settings.yaml.

7. Development

# Clone repository
git clone https://github.com/cinob/dsh-web-search-multi.git
cd dsh-web-search-multi

# Build client and server bundles
npm run build

# Run unit tests
npm test

8. License

MIT License.

Repository: https://github.com/cinob/dsh-web-search-multi