SEARXNG 搜索源 n0pe-sled/web-search-searxng

dsh-web-search-searxng

一个仅运行在宿主端的 DeepSeek Harness 插件，向 web 能力接缝（ctx.web）注册一个 由 SEARXNG 提供支持的搜索服务商。它和内置的 web-search-deepseek、web-search-exa、web-search-perplexity 服务商并列；面向模型的 web_search 工具仍归 @deepseek-ai/dsh-tool-web 所有。

如何接入

- 接缝（@deepseek-ai/dsh-web）负责选择服务商，依据 web 行的 searchProvider 配置（或 $DSH_WEB_SEARCH_PROVIDER，或当恰好注册了一个可用服务商时自动选择）。
- 本服务商以 id searxng 注册，调用你实例的 JSON API：GET {baseURL}/search?q=<query>&format=json。
- web_search 的错误走接缝的 WebError 分类：调用方取消时返回 WEB_ABORTED；请求、超时、HTTP 或响应无法解析时返回 WEB_PROVIDER_ERROR。

安装

把 bundle 加入配置档，并让接缝指向它。在配置档的补丁层（例如 web 配置档上的 $DSH_HOME/cordis.patch.yml）：

- insert:
- id: web-search-searxng
name: dsh-web-search-searxng

Point the seam's search at the SEARXNG provider (replaces the base row's config).
- id: web
name: '@deepseek-ai/dsh-web'
config:
searchProvider: searxng

然后重启 GUI。在 web 界面上，web_search 工具本身由智能体预设按会话挂载，无需额外启用工具。

配置（插件行）

| 键 | 默认值 | 含义 |
| baseURL | https://search.catrambone.org | 实例基础 URL；会自动追加 /search。 |
| engines | 未设置 | 逗号分隔的 SEARXNG 引擎过滤（engines=）。 |
| categories | 未设置 | SEARXNG 分类过滤（categories=）。 |
| language | 未设置 | SEARXNG 语言提示（language=）。 |
| timeoutMs | 15000 | 整个请求的超时，单位 ms。 |

- id: web-search-searxng
name: dsh-web-search-searxng
config:
baseURL: https://search.catrambone.org
engines: google,duckduckgo

映射

每个 results[] 条目映射为一个 WebSearchSource：url（必需，缺失则丢弃该条目）、title、来自 content 的 snippet，以及实例返回 publishedDate 时来自它的 publishedAt。结果按 URL 去重（同一页面可能出现在多个引擎下）。SEARXNG 不返回生成的答案，所以省略 content；maxResults 截断由接缝负责。

验证

node tests/smoke.mjs # mapping, availability, apply registration, local round trip

服务商的 search() 也直接对线上实例跑过：deepseek harness 返回约 28 个映射后的来源，带标题和摘要。