cinob/dsh-web-search-multi

🌐 多提供商网页搜索插件,适用于 DeepSeek Harness:零密钥 Bing/Baidu 直接搜索,免费层 API(Tavily/Brave/Serper/Bocha),SearXNG 令牌认证,自动回退,以及内置 Web 设置图形界面。

项目介绍Project Overview

dsh-web-search-multi 是 DSH 的多源网页搜索插件,支持 360、Bing、百度、Tavily、Brave、Serper、博查、SearXNG 与 DuckDuckGo,提供自动故障回退和 Web 设置界面。适合需要在 DSH 中接入免费或自托管搜索、配置密钥并实时测试连接时使用。注意:部分引擎需 API Key 或 SearXNG 实例,插件会向所选服务商发起出站 HTTPS 请求。

dsh-web-search-multi is a DSH plugin for multi-provider web search, supporting 360, Bing, Baidu, Tavily, Brave, Serper, Bocha, SearXNG, and DuckDuckGo with automatic fallback and a Web Settings UI. Use it to add free-tier or self-hosted search, configure credentials, and test connections in DSH. Caveat: some providers require an API key or a SearXNG instance, and the plugin sends outbound HTTPS requests to selected services.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

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

cinob/dsh-web-search-multi 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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 | 简体中文

license GitHub dsh-plugin


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

  1. Start DSH Web:
    dsh web
    
  2. Open Web GUI (http://127.0.0.1:3080) -> Click Settings (Gear icon) -> Select 多源 Web 搜索 in the sidebar.
  3. Choose your preferred search engine or leave it on 自动策略 (Auto).
  4. (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.

上一个 Prev dsh-version-autoupdate 下一个 Next dsh-msg-hub