@deepseek-ai/dsh-web-search-searxng

English | 中文

为 DeepSeek Harness 的 web 能力 seam（ctx.web）提供基于 SearXNG 的 WebSearchProvider。它调用 SearXNG 实例的 JSON API（/search?format=json），把聚合结果映射为 seam 标准化的 WebSearchResult。

这是一个实现包：它向 ctx.web 注册 provider，通过 ctx.credentials 或进程环境解析可选的 API key，在有发起方 Agent 时把辅助请求记录到会话中，且不注册任何面向模型的工具。它是一个函数/命名空间插件（inject: ['web']）。

为什么用 SearXNG

• 自托管、隐私：查询发往你自己的实例，不经过第三方搜索厂商。
• 每次搜索零模型成本：与需要发起完整模型调用的厂商搜索不同，一次搜索只是一个 HTTP GET——又便宜又快。
• 多引擎聚合：SearXNG 在一个端点后聚合 Bing、Brave、Baidu、Google、DuckDuckGo 等。
• 可移植：把 baseURL 指向任意 SearXNG——本地 Docker、局域网实例或公共实例均可。

依赖

• 一个 DSH 主机可达的 SearXNG 实例（默认 http://localhost:8080）。
• 挂载了 web seam 的 DeepSeek Harness profile（所有标准 profile 都自带）。

安装

一键安装（bundle）

本包声明了 dsh.bundle.patch（cordis.patch.yml），因此一条 dsh plugin add 即可同时完成"注册插件 + 切换 web seam"，无需手动编辑任何 YAML：

dsh plugin --profile web add /path/to/dsh-web-search-searxng

配置优先走环境变量——启动 dsh 前设置即可，完全不用改配置：

export SEARXNG_BASE_URL=http://localhost:8080   # 可选；默认 http://localhost:8080
export SEARXNG_MAX_RESULTS=10                    # 可选；默认 10
export SEARXNG_LANGUAGE=en                       # 可选；默认 'all'（不传该参数）

手动安装（本地开发）

# 1. 让包能从 profile 的 node_modules 解析
ln -sfn /path/to/dsh-web-search-searxng \
        "$DSH_HOME/profiles/node_modules/@deepseek-ai/dsh-web-search-searxng"

# 2. 在 cordis.patch.yml 中注册插件并切换搜索 provider（见下方配置）

- insert:
    - id: web-search-searxng
      name: '@deepseek-ai/dsh-web-search-searxng'
      config:
        baseURL: http://localhost:8080
        maxResults: 10

- id: web
  config:
    searchProvider: searxng-local

重启 DSH 进程（或 GUI）使 patch 生效。

web profile 默认禁用 HMR 重载；修改 cordis.patch.yml 后需要重启进程。