前言¶
在 DeepSeek Harness（DSH）里做联网检索，常见做法是接 SearXNG 自建实例，或用平台内置的 DeepSeek 官方搜索。前者可控、可私有化，但依赖 Docker 与网络；后者开箱即用，却未必符合你的部署策略。若希望「平时走 SearXNG，实例挂了再自动切官方搜索」，需要在 ctx.web 这一层做 provider 编排。@clinkai/dsh-web-search-fallback 就是面向该场景的 DSH 插件，由社区维护者 w384 发布，目录分类为联网工具。
需要提前说明：该包在 npm 与 GitHub 上已标记为 deprecated，核心能力已合并进 @clinkai/dsh-web-search-searxng。下文先说明本插件的定位与行为，再给出迁移方式；若你尚未安装旧包，可直接安装合并后的新包。
这是什么¶
@clinkai/dsh-web-search-fallback（GitHub：w384/clinkai-dsh-web-search-fallback）是 DeepSeek Harness 的 web seam（ctx.web）插件：以 SearXNG 为主搜索源，当 SearXNG 或 Docker 不可达时，自动回退到内置 DeepSeek 搜索。
- 维护者：w384
- 版本（package.json）：0.1.0
- 许可证：MIT
- 运行要求：Node.js
>=20.3；DSH>=0.1.5-rc.2 <1.0.0 - 对等依赖：
@deepseek-ai/dsh-web、@deepseek-ai/schemastery（均为 optional peer）
插件通过 Cordis patch（cordis.patch.yml）注册 provider，不 import 具体 provider 实现，而是在调用时按 provider id 解析，因此也可作为「给其他主 provider 包一层回退」的通用包装器保留使用。
核心功能¶
README 与合并说明中可核实的行为如下。
-
SearXNG 优先
联网检索默认走 SearXNG 路径（与 DSH web 插件体系中的 SearXNG provider 配合使用）。 -
自动回退
在以下情况可改走fallbackProvider（默认deepseek-official）：
- 连接失败
- 内部超时
- HTTP 5xx
- 可选：空结果时也回退（具体是否启用取决于你在合并包中的配置；迁移后 provider id 与配置字段保持不变） -
与合并后包的关系
@clinkai/dsh-web-search-searxng一次安装注册两个 provider：
| provider id | 行为 |
|---|---|
searxng |
纯 SearXNG |
search-fallback |
先 SearXNG，失败/超时/5xx（及可选空结果）时走 fallbackProvider |
官方说明：若你已在用 search-fallback 的 provider id 与配置，无需改配置，换包即可。
- 维护状态
本仓库不再更新；日常 SearXNG + 回退场景应使用@clinkai/dsh-web-search-searxng。
安装与迁移¶
已抓取资料中未给出本插件最初的 dsh plugin add 安装命令，请勿凭仓库名自行拼接。若你当前 profile 里仍装着旧包，README 给出的迁移步骤如下。
先从 web profile 移除旧插件，再添加合并后的 SearXNG 包：
dsh plugin --profile web remove @clinkai/dsh-web-search-fallback
dsh plugin --profile web add github:w384/clinkai-dsh-web-search-searxng
经过上面的步骤，原先使用的 search-fallback provider id 与相关配置可继续使用，行为由新包提供。
若你从未安装过本插件、只需要「SearXNG + 官方搜索回退」，应直接查阅 clinkai-dsh-web-search-searxng 的安装与配置说明，而不是安装已 deprecated 的 @clinkai/dsh-web-search-fallback。
典型用法与配置¶
资料中未展开本仓库独立的 YAML 配置示例；实际用法是在 DSH 的 web 配置里选用 provider id search-fallback（迁移后仍为此 id），并按需指定 fallbackProvider（默认 deepseek-official）。具体字段与示例以合并仓库 README 为准。
通用回退包装器场景：若主 provider 不是 SearXNG，仍可将本仓库思路（按 id 查找、不绑定具体实现）用于自定义主源 + 回退链；该用法属于进阶扩展，需自行阅读 lib/index.js 与 patch 定义。
适用场景与注意¶
适合谁
- 已在 DSH
webprofile 中使用 SearXNG，并希望 SearXNG/Docker 异常时自动改用 DeepSeek 官方搜索，避免智能体整条联网链路中断。 - 需要理解 deprecated 状态，并愿意迁移到
@clinkai/dsh-web-search-searxng的长期维护路径。
注意
- 插件在 当前 dsh 进程的权限与环境 下运行，安装前请阅读源码与 MIT 许可证，确认网络出站与 SearXNG 地址符合你的安全策略。
- DSH 社区插件目录（如 SkillHub 条目）为独立生态站点，与 DeepSeek / 幻方无官方从属关系；版本与说明以 GitHub 与 npm 为准。
- 不要编造未在文档中出现的配置项；星标、案例与用户数据以公开仓库页面为准（当前 GitHub 星标为 0）。
结尾¶
@clinkai/dsh-web-search-fallback 解决的是 DSH 联网检索里「SearXNG 优先、失败回退官方搜索」的编排问题；能力已并入 @clinkai/dsh-web-search-searxng，新用户应直接安装合并包。查阅目录与源码：
- 目录页：https://www.skillhub.cn/plugins/w384/clinkai-dsh-web-search-fallback
- GitHub：https://github.com/w384/clinkai-dsh-web-search-fallback
- 推荐后续包：https://github.com/w384/clinkai-dsh-web-search-searxng
