dsh-searxng-search

DSH PLUGIN记忆与知识

仓库 Jfreey/dsh-searxng-search · npm dsh-searxng-search

记忆与知识 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness 提供免 API Key 的本地 SearXNG 搜索,自动安装守护实例并智能推荐可用引擎。

一句话选型结论

按资料字段整理

dsh-searxng-search 是记忆与知识类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类记忆与知识 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-06 创建于 2026-11-05
README 9.9 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:Jfreey/dsh-searxng-search
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-searxng-search可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-searxng-search:为 DeepSeek Harness 提供本地自托管搜索

  • 免 API Key 本地搜索
  • 自动安装并守护 SearXNG
  • 按网络实测推荐引擎
  • 聚合多引擎无广告追踪
  • 支持出站代理配置

适用场景

联网搜索

上游标签

deepseek-harnessdshdsh-plugindsh-pluginslocal-firstmetasearchsearch-enginesearxngweb-search

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-11): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在记忆与知识场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-searxng-search当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方Jfreey仓库 dsh-searxng-search · 默认分支 main
分类记忆与知识knowledge
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-05 · 2026-11-06最后推送 2026-11-06
本站收录2026-11-05首次进入本站目录的时间

README 全文

9.9 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-searxng-search

English | 中文

给 DeepSeek Harness 的一键本地搜索。它在你自己机器上装好
SearXNG、保持它活着,再把 web_search 指过去。

  • 无需 API。 不用注册、不用存任何厂商密钥,装完就能搜。
  • 完全免费。 自己托管:没有订阅、没有按次计费、没有额度。
  • 自动选最佳线路(靠实测,不靠猜)。 设置页在你自己的网络上逐个实测引擎,按应答、延迟、
    产出打分,一键选出能用的组合。
  • 结果干净。 SearXNG 聚合多个高效引擎(Bing、Sogou、360search 等),无广告、无追踪、
    无跳转包装。

基座把 ctx.web 钉在 searchProvider: deepseek-official 上,那个 provider 需要
DEEPSEEK_API_KEY。没有密钥时 searchReady() 返回 false,web_search 会被从每
一个模型步骤里摘掉——agent 只剩 web_fetch。这个插件注册一个不需要任何凭证的
provider,指向你自己跑的 SearXNG。

它加了什么

部分 作用
Provider 在 ctx.web 上注册搜索 provider searxng。原生 web_search 的 schema、排版、结果卡片全部不变。
守护 每次搜索前探 /healthz;服务挂了就按平台拉起:launchd、systemd、Windows 计划任务,或插件自己持有的子进程。
安装器 scripts/bootstrap-searxng.sh(macOS、Linux)与 scripts/bootstrap-searxng.ps1(WSL),幂等安装或修复,绝不覆盖已有配置文件。
设置页 按类别分组的引擎表、一键实测本机可达的引擎、推荐名单、出站代理。
代理 读写 SearXNG 的 outgoing.proxies.all://,让引擎请求走本地代理。

环境要求

  • 支持 dsh.bundle 的 DeepSeek Harness 与一个 profile。
  • 一个可达的 SearXNG 实例。安装器需要 git、Python 3.11+,以及 macOS、Linux 或 WSL。
  • SearXNG 必须支持 JSON 输出:search.formats 里要有 json。

安装

# 1. 先有一个 SearXNG(已经有了就跳过)
./scripts/bootstrap-searxng.sh            # macOS / Linux
./scripts/bootstrap-searxng.sh --print    # 只看计划,不动手

# 2. 把插件装进 DSH profile
#    DSH 里:插件 → 从目录安装;或
#    dsh plugin install /path/to/dsh-searxng-search

已有实例改 config.baseUrl 即可;实例在别的机器上(例如 NAS)时,用
ensure.enabled: false 关掉守护,交给那台机器自己管。

端口被占用

安装器在目标端口被别的程序占着时会直接拒绝,并点名占用者:

Port 8888 is taken by another process:
python3.1 (pid 835)
Nothing was installed. Use another port, and set the plugin's baseUrl to match:
SEARXNG_PORT=8899 ./scripts/bootstrap-searxng.sh
config.baseUrl: 'http://127.0.0.1:8899'

如果占用者是健康的实例,或者是卡在重启循环里的 SearXNG 进程,则视为“自己人”,
原地修复。没有自动换端口的回退——安装器和插件必须对同一个端口达成一致,所以端口
在两边都保持为一个显式值。插件连不上配置的端口时,会扫 8888–8896,找出同时满足
/healthz 可达且 /config 返回引擎列表的实例,并在错误里告诉你该改成哪个地址。

配置

- id: searxng-search
name: 'dsh-searxng-search'
config:
baseUrl: 'http://127.0.0.1:8888'
settingsPath: '~/.local/share/searxng/searxng.yml'   # 可省略,这是默认值
id: searxng              # web 服务钉住的 provider id
maxResults: 20           # provider 侧上限,工具还会再截一次
timeoutMs: 20000
safesearch: 0
probeTimeoutMs: 12000    # 单个引擎的探测超时
# 可选的 SearXNG 查询参数,留空则不传:
# language: zh-CN
# categories: general
# engines: google,bing
ensure:
enabled: true
healthPath: /healthz
probeTimeoutMs: 1500
startupTimeoutMs: 20000
probeIntervalMs: 400
retryCooldownMs: 15000
launchAgent: com.searxng.server   # macOS
systemdUnit: ''                   # Linux,例如 searxng.service
windowsTask: ''                   # Windows(仅 WSL)
windowsService: ''
command: ''                       # 通用兜底,进程归插件
args: []
cwd: ''
env: {}

平台

平台 守护方式 安装器 状态
macOS LaunchAgent → launchctl kickstart -k gui// bootstrap-searxng.sh 真机验证:安装、自愈、干净卸载
Linux systemd user unit → systemctl --user restart,失败退到 systemctl restart bootstrap-searxng.sh 在 Ubuntu 24.04 容器里验证过安装、配置、JSON API 与插件往返;unit 本身只用 stub 的 systemctl 验过
Windows — bootstrap-searxng.ps1 在非 WSL 环境直接拒绝 原生不支持:SearXNG 的 searx/valkeydb.py 导入了 POSIX 专有的 pwd,进程在 import 阶段就死。走 WSL、Docker,或用 config.baseUrl 指向 Linux/macOS 上的实例

插件本身是纯 Node,任何平台都能跑;受限的只有服务端。

守护怎么工作

每次 web_search 先探 GET /healthz(1.5 秒预算)。服务掉线就拉起来并轮询到健康
(20 秒预算),然后执行搜索:

  1. 当前平台配置好且已安装的托管器——进程归它,插件不杀。
  2. 否则用 ensure.command,插件通过 ctx.subprocess 拉起、持有,卸载时回收。
  3. 都没有 → 搜索失败,错误信息列出试过什么、该配哪一项或跑哪个安装器。

启动失败会记 15 秒冷却,并发搜索共用同一次恢复。provider 不实现 ready(),所以
web_search 永远在工具列表里:服务挂了是模型能读懂的错误,而不是工具凭空消失。

引擎页

打开页面时会自动测试你已经勾选的引擎,所以表格不会是空的;之后可以随时重测。按 0–100 打分:

分项 分值 规则
应答 55 返回合法 JSON 且 unresponsive_engines 里没有它
延迟 25 / 18 / 10 / 4 / 0 ≤0.8 秒 / ≤2 秒 / ≤5 秒 / ≤15 秒 / 更慢
产出 20 / 12 / 4 ≥5 条 / 1–4 条 / 无结果

这是可用度,不是准确率:没有任何环节拿引擎的答案去跟标准答案比对。准确率需要
标注语料或跨引擎一致性采样,页面不假装自己有。

评分之上会给出两类建议——根本没应答的(CAPTCHA、被拦、被挂起)和慢于 5 秒的,
并配一个「按建议调整勾选」按钮,只取消这两类。0 条结果不算建议:探针只问一个短词,
汇率或翻译类引擎在 5 毫秒内返回空结果是正常的,这类只作为提示列出。

应用会为每个引擎写一条显式开关(- name: "<引擎>" + disabled: true|false),
并移除 use_default_settings.engines.keep_only。那个白名单是单向门——写进去之后
/config 只返回名单内的引擎,其余全部从页面消失且再也打不开。首次应用会把配置迁
移出白名单;页面同时会解析 SearXNG 自带的 searx/settings.yml,所以即使在迁移前,
可选目录也是完整的。

每次写入都在配置文件旁留一份带时间戳的备份,重启实例、等待健康;没起来就自动回滚。

安全

  • 不碰凭证。 provider 没有 key,也不实现 ready()。
  • 默认只听回环。 安装器绑 127.0.0.1。SEARXNG_BIND=0.0.0.0 是为容器准备的,
    暴露面由你决定。
  • 只写一个文件——你的 searxng.yml,且只在页面上点应用/保存代理时:先备份、再写、
    再校验,失败回滚。
  • 进程控制限于配置里的托管器:launchctl、systemctl、schtasks 或显式的
    ensure.command;不按名字扫进程,也不杀不认识的进程。
  • 没有遥测、没有外部请求。 唯一的网络流量是发给你自己的实例。
  • 结果是外部数据。 走原生 web_search 的格式化与 harness 的不可信内容提示,不做
    任何额外处理。

排错

现象 原因
工具列表里没有 web_search 钉住的 provider 不可用。检查 web.provider / searchProvider,或看 GET /dsh-searxng/engines。
搜索返回 0 条 引擎名单为空,或全部被 CAPTCHA 挡了。去设置页测一遍。
did not answer within N ms 实例挂了且没拉起来,错误里会写明是哪个策略失败的。
搜索报 HTTP 500 SearXNG 拒绝 JSON 输出,给 search.formats 加上 json。
应用之后引擎全消失 旧版本:应用会写 keep_only。升到 0.4.3+,再应用一次完成迁移。

代码结构

文件 作用
index.js 宿主插件:provider、守护、跨平台重启
engines.js 纯函数:评分、名单/代理的文本手术、目录解析
engine-api.js 宿主路由:GET /dsh-searxng/engines、POST /probe、/apply、/proxy
client.js 设置页:表格、测试/应用按钮、代理输入、中英词典
scripts/bootstrap-searxng.sh macOS 与 Linux 的幂等安装器
scripts/bootstrap-searxng.ps1 同上,供 WSL 使用;原生环境直接拒绝

路由只返回 JSON,页面只负责渲染,从不直接改配置文件。

已知限制

  • 安装器只覆盖 macOS LaunchAgent 与 systemd user unit,其他 init 系统不在范围内。
  • 在 CN 线路上 bing、sogou、360search 最稳;上游默认的 google、brave、
    duckduckgo、startpage、qwant、baidu 普遍被 CAPTCHA 或限流,wikipedia
    可能拖到 15 秒,因此被排除在默认名单外。
  • 搜索请求只带 query;时效和域名过滤 harness 这层还没开放。
  • 准确率的问题,这里故意不回答。

许可

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-searxng-search 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:Jfreey/dsh-searxng-search` 即可。对应的 npm 包名是 `dsh-searxng-search`。

dsh-searxng-search 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-searxng-search 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-searxng-search 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-searxng-search 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-searxng-search 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-searxng-search 有哪些功能?

免 API Key 本地搜索、自动安装并守护 SearXNG、按网络实测推荐引擎、聚合多引擎无广告追踪、支持出站代理配置。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

2 条
不同作者的仓库分开列,请确认你要装的是哪一个
记忆与知识
按星标排序,可作替代方案

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

Jfreey 的其它插件

2 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-11。