chinng-inta/dsh-web-search-searxng

Plugin插件 Native原生 ⭐ 4 MIT Search & Web Access搜索与联网

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness that provides a SearXNG-backed web search provider for DSH's ctx.web capability seam. Unlike the default shipped web search provider that requires an API key and consumes a full model turn for each search, this plugin makes a plain JSON retrieval call to your own SearXNG instance, cutting extra costs and latency. You can install it via npm using the command dsh plugin --profile web add dsh-web-search-searxng, or install directly from the GitHub repository. If you install from source, you will need to allow the build script in your pnpm workspace to complete the installation.

The plugin does not register a new model-facing tool, instead it integrates with the existing @deepseek-ai/dsh-tool-web to connect the existing web search tool to your self-hosted SearXNG instance. It supports a full set of optional configuration options, including search categories, specific engines, language, time range, safesearch level, timeout, maximum snippet characters, and extra headers for proxied instances. All configuration changes take effect immediately for the next search without requiring a DSH restart, and the base URL can also be pulled from an environment variable if not set in the config file.

Before using the plugin, you must enable JSON output in your SearXNG instance's settings.yml, because it is disabled by default. Public SearXNG instances typically block programmatic access via bot filters or aggressive rate limiting, so the project documentation strongly recommends running your own self-hosted instance. There are a few known limitations, including the inability to push down a max result count, missing published dates from non-news results, no infobox support, and no per-engine failure reporting. All these limitations do not block core web search functionality, and only affect advanced use cases.

这是一款专为 DeepSeek Harness 开发的原生网页搜索插件,基于自托管元搜索引擎 SearXNG 实现,为 DSH 的 ctx.web 能力接口提供 WebSearchProvider 实现。和 DSH 官方自带的搜索提供程序不同,它无需 API 密钥,也不会消耗模型轮次,仅调用 SearXNG 实例的 JSON 接口获取纯检索结果。用户可通过 npm 或 GitHub 源码两种方式安装,需匹配对应版本的 DSH 预发布分支。

插件本身不会注册面向模型的工具,仅为现有 @deepseek-ai/dsh-tool-web 提供自定义后端支持,让原有网页搜索工具对接用户自己的 SearXNG 实例。插件支持配置搜索分类、引擎、语言、时间范围、安全搜索等级等参数,所有配置项均为可选,未配置时使用 SearXNG 实例默认值。配置修改后无需重启 DSH 即可生效,baseURL 还支持从环境变量读取。

需要注意,SearXNG 默认未开启 JSON API,用户需要手动修改实例的 settings.yml 开启,否则插件无法正常工作。公开的 SearXNG 实例大多会拦截程序化访问,建议自行部署实例。插件基于 MIT 许可开源,目前存在部分已知限制,比如无法传递最大结果数参数、不展示信息框等,不影响基础使用。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add dsh-web-search-searxng

把 chinng-inta/dsh-web-search-searxng 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-web-search-searxng

A SearXNG-backed WebSearchProvider for the DeepSeek Harness web capability seam (ctx.web).

SearXNG is a self-hosted metasearch engine. One search here is a plain retrieval call against the instance's /search?format=json endpoint, so unlike the shipped DeepSeek provider it needs no API key and costs no model turn — the shipped provider issues a full Messages request with the native web_search server tool, paying latency and generated tokens for every search.

This is an implementation package: it registers a provider into ctx.web and does not register a model-facing tool. @deepseek-ai/dsh-tool-web owns web_search, its schema, its prompt guidance, and the result card. Installing this package makes that existing tool work against your own instance.

Install

From npm

dsh plugin --profile web add dsh-web-search-searxng

From this repository

dsh plugin --profile web add github:chinng-inta/dsh-web-search-searxng

A git dependency ships no lib/, so the package builds itself through its prepare script — and pnpm blocks install scripts until you allow them. The first run therefore fails and prints the exact key to allow. Add it to your profile's pnpm-workspace.yaml and re-run:

allowBuilds:
  "dsh-web-search-searxng@https://codeload.github.com/chinng-inta/dsh-web-search-searxng/tar.gz/<commit-sha>": true

The key pins a commit, so it changes whenever you install a newer revision. Building from source also needs the dev toolchain fetched (~20 s versus ~2 s for the registry). Prefer npm unless you are tracking unreleased changes.

Either way

The package declares dsh.bundle, so a single command also activates it: the bundle patch inserts the provider row and selects it on the web row. Point it at your instance and restart:

export SEARXNG_URL=http://searxng.internal:8888

Verify the composition before booting:

dsh --profile web --dump-config | grep -A3 'id: web'

Your instance must serve JSON

SearXNG does not enable the JSON API by default. In the instance's settings.yml:

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev agentduel-dsh 下一个 Next canvas-workbench →