前言¶
在 DeepSeek Harness (DSH) 的開發實踐中，web_search 是智能體獲取外部信息的常用接口。默認情況下，這通常指向第三方搜索 API。當需要自建搜索實例以控制數據隱私、降低 API 調用成本，或應對網絡環境限制時，將 web_search 的後端切換爲自建的 SearXNG 是常見需求。biyuhao/dsh-web-searxng 插件爲 DSH 提供了這一能力，將 SearXNG 註冊爲 web_search 的 provider。
插件介紹¶
該插件通過 SearXNG 提供自託管的搜索後端，支持 provider id searxng。所有者爲 biyuhao，許可證爲 MIT。插件包含服務端（host）和客戶端（client）代碼，無需將查詢直接發送給第三方搜索引擎。
安裝與依賴¶
安裝前請確保運行環境滿足以下要求：
* Node.js 版本 >= 20
* 當前激活的 DSH profile 爲 web profile
使用官方命令安裝：
dsh plugin --profile web add dsh-web-searxng
安裝完成後，重啓 dsh web 進程使配置生效。
核心功能¶
插件提供以下功能：
- 設置頁配置：提供完整的配置卡片，支持設置實例地址、BasicAuth 認證、搜索分類、語言、安全搜索級別以及出境代理（支持 http/https/socks5h）。
- 連接測試：支持一鍵測試連接，返回可用性狀態、延遲時間及結果條數。測試失敗會明確顯示原因（如 403 未開啓 JSON、429 限流等）。
- 社區實例選擇：集成 searx.space 社區實例，提供選擇器功能。支持自動測速，當可用實例達到 10 個時會停止拉取。
- 名單管理：提供一鍵刷新社區實例名單的功能，基於當前配置的代理進行拉取和緩存。
- 中英雙語：界面支持中英文切換。
配置說明¶
配置優先級爲：設置頁 > composition entry > 環境變量。主要配置項如下：
| 字段 | 說明 | 默認值 |
|---|---|---|
baseURL |
SearXNG 實例地址。留空表示未配置，provider 不可用。 | "" |
username / password |
BasicAuth 認證憑據。公用實例留空則不發送認證頭。 | "" |
categories / language |
SearXNG 搜索參數。 | general / zh-CN |
safesearch |
安全搜索級別。0 關閉，1 中等，2 嚴格。 |
1 |
proxyUrl |
出境代理地址。留空表示直連。出境受限環境必填。 | "" |
proxyEnabled |
代理開關。關閉後走直連，但地址保留在配置中。 | true |
典型用法¶
設爲默認搜索¶
當 DSH 中存在多個搜索 provider 時，若未指定默認 provider，可能會報錯 WEB_PROVIDER_AMBIGUOUS。通過 patch 命令將默認 provider 指向 searxng：
# 創建一個臨時 patch 文件，內容如下：
# - id: web
# config:
# searchProvider: searxng
# fetchProvider: http
dsh --profile web --patch ./pin-searxng.patch.yml
或者直接修改 profile 配置文件 ~/.dsh/profiles/web/cordis.patch.yml，將 searchProvider 和 fetchProvider 設置爲 searxng 和 http。
驗證功能¶
配置完成後，可在 DSH 控制台調用 web_search 驗證：
web_search({queries: ["searxng format=json"]})
安全與部署注意事項¶
- 密碼存儲：插件將密碼以明文形式存儲在本地 settings 文檔中，這與使用環境變量（
SEARXNG_USERNAME/SEARXNG_PASSWORD）的安全敏感度相同。 - 社區實例風險：使用社區實例時，查詢內容爲明文傳輸，且無法驗證服務端行爲。請勿在社區實例中搜索敏感內容。
- 引擎選擇：不要在自建實例中添加 Google 引擎，因爲 VPS IP 容易觸發 CAPTCHA 驗證，導致搜索失敗。
- 自建部署：項目
deploy/目錄提供了基於 Docker Compose 的部署方案，包含 Caddy 反向代理配置，單核 1G 內存 VPS 可穩定運行。
生態背景¶
DSH 理念是“一切皆插件”。本插件託管在 GitHub 上，社區目錄提供了插件索引。
