返回目录

dsh-web-search-multi

精选清单收录维护状态: 活跃

zmh2000829/dsh-web-search-multi

原生 web_search 工具的多后端选择插件:SearXNG、Brave、Tavily、Gemini 搜索落地或维基百科,无隐式回退。

前往 GitHub
$ dsh plugin add dsh-web-search-multi

安装

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

了解安装方式

6

星标

0

Fork

TypeScript

语言

MIT

许可证

2026-08-18

创建于

2026-09-24

最近推送

README

dsh-web-search-multi

English | 中文

Configure web search in DeepSeek Harness: choose SearXNG, Brave, Tavily, Gemini, or Wikipedia in Web settings and enable or disable search independently below each conversation's composer. The plugin uses DSH's native web_search tool. The default Wikipedia backend needs no API key and provides an easy first encyclopedia query.

Providers

Provider General web API key Cost profile Main limitation
searxng Yes No Free when self-hosted You operate the instance and its upstream engines
wikipedia No No Free public Wikimedia API Encyclopedic knowledge only
tavily Yes Yes Free monthly credits, then paid Account and usage quota
brave Yes Yes Monthly credits, then paid Subscription setup and usage quota
gemini Yes Yes Google AI Pro can redeem monthly Cloud credits API billing is separate and requires Cloud Billing

Pricing and quotas can change. Check the provider's current terms before deployment. The plugin sends each query only to the selected provider; it has no implicit fallback or fan-out.

Requirements

  • The current plugin 0.2.3 requires dsh 0.1.5-rc.2. Plugin 0.2.0 targets DSH 0.1.1-rc.2 and is not compatible with the newer settings API.
  • Node.js ^22.19 or >=24
  • No credential for the default Wikipedia backend; a JSON-enabled SearXNG instance or API credential for the other backends

Install

Recommended npm installation for DSH 0.1.5-rc.2:

dsh plugin --profile web add dsh-web-search-multi@latest

Restart dsh web after installation. Start with an encyclopedia query using the default Wikipedia backend. For general web information such as news or weather, open the “Multi-provider web search” settings card, choose a provider, configure its credentials or SearXNG URL, and select “Test configuration.” Search starts enabled in each conversation.

From a local clone for development:

npm ci
npm run check
dsh plugin --profile web add link:$PWD

For DSH 0.1.1-rc.2, install the previous release:

dsh plugin --profile web add dsh-web-search-multi@0.2.0

For a Git source install, pnpm may initially block the package's prepare build. Follow the allowBuilds instruction printed by dsh, then repeat the install command.

The package is a DSH bundle. Installation adds its cordis.patch.yml, selects the stable provider id configurable-search, and starts with keyless English Wikipedia so the first test works without another service. Select SearXNG, Brave, Tavily, or Gemini in the Web UI when broader web coverage is needed. The plugin does not install or start SearXNG.

The composer tool row has a two-part pill for each conversation: select On on the right to enable search or Off on the left to disable it. It starts on, and the choice survives DSH restarts. Off removes web_search from that conversation's available tools and prompt guidance and blocks direct calls; it does not disable web_fetch or Grok Build's own search. A search already running when you switch off may finish; the new choice applies to subsequent tool calls and model requests. Provider selection in Settings is still shared across conversations.

Free local SearXNG

The included Compose deployment binds only to localhost and enables JSON output. Start it once from this repository checkout; the container uses restart: unless-stopped:

docker compose -f deploy/searxng/compose.yml up -d
curl -fsS -X POST http://127.0.0.1:8080/search \
  -d 'q=DeepSeek&format=json'

If the plugin was installed from GitHub and no checkout exists locally, clone https://github.com/zmh2000829/dsh-web-search-multi.git, enter that directory, and run the Compose command above. Stop it with docker compose -f deploy/searxng/compose.yml down. Enabling, disabling, or removing the DSH plugin does not start or stop this service.

Do not expose this configuration publicly without adding authentication, rate limiting, a unique secret, and the other protections required by the SearXNG deployment guide.

Configure

Edit $DSH_HOME/profiles/web/cordis.patch.yml (~/.dsh is the default home). A profile patch replaces the complete config value, so keep every required key shown in the selected example.

All providers accept the top-level requestTimeoutMs setting from 1000 through 55000; its default is 25000, below the Harness tool deadline.

The same configurations are available as ready-to-use files under examples/; use dsh --profile web --patch examples/wikipedia.patch.yml for a temporary override.

Web UI

Open Settings → Plugins → Plugin configuration → Multi-provider web search. The card lets you select all five providers, edit provider-specific options, and save Brave, Tavily, or Gemini keys without putting a secret in settings. A saved key goes through DSH credentials and the card receives only its configured/writable status. Test configuration runs one real DeepSeek query against the current draft without saving first; success reports latency, result count, and the first title, while failure reports the provider error. Provider and option changes apply to the next search without restarting DSH.

The stock Web search card belongs to the bundled DeepSeek provider. Use the separately named Multi-provider web search card for this plugin.

SearXNG

- id: web-search-multi
  config:
    provider: searxng
    searxng:
      baseURL: http://127.0.0.1:8080
      language: all
      safeSearch: 1

在 GitHub 阅读完整 README →

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。