多后端可切换：DeepSeek 官方 / AnySearch / Bing / DuckDuckGo / DuckDuckGo Lite / SearXNG
即时生效：设置面板或 search_router_switch 工具切换后，下一次 web_search 立即使用新后端，无需重启
状态可查：search_router_status 工具显示当前后端、回退链、最近一次失败
自动回退：当前后端失败/无结果时按回退链尝试，默认最终回退到 deepseek-official，结果中附 Note: ... 说明实际生效后端
中文设置面板：与官方插件配置页样式一致，可收缩展开；支持填写 AnySearch / DeepSeek Key（保存后脱敏显示）
密钥优先级：面板填写 > 环境变量 > ~/.dsh/.env > ~/.dsh/.credentials.yaml
非破坏性：只新增配置与插件包，不修改 DSH 源码，不覆盖现有凭据

安装

从 npm

npx -y @deepseek-ai/dsh plugin --profile web add dsh-search-router

重启 dsh Web UI 后生效。

从本地开发目录

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

构建（可选，源码方式）

cd dsh-search-router
pnpm install
# 如果本地已安装 devDependencies，可以直接：
npm run build
# 否则指定一个 DSH 源码 checkout：
DSH_CHECKOUT=/path/to/deepseek-harness npm run build

构建后产物：

lib/index.js：Host 插件
lib/client.js：设置面板客户端

使用

打开 设置 → 插件 → 插件配置 → 搜索路由，选择搜索后端、调整单次结果上限、填写密钥。
或在会话中让 agent 调用：
- search_router_switch 切换后端
- search_router_status 查看状态

支持的搜索后端

provider id	说明	凭据
`deepseek-official`	DeepSeek 官方搜索（Anthropic 兼容 Messages API）	`DEEPSEEK_API_KEY`
`anysearch`	AnySearch REST 搜索	`ANYSEARCH_API_KEY` 可选，缺省匿名
`bing`	Bing 网页搜索（HTML 抓取，默认 zh-CN）	免费
`ddg`	DuckDuckGo HTML 搜索	免费
`ddg-lite`	DuckDuckGo Lite 搜索	免费
`searxng`	SearXNG 元搜索（公开实例）	免费

配置

权威配置：DSH 设置命名空间 search-router
默认位置：~/.dsh/settings.yaml 中 search-router: 段
设置服务不可用时回退：~/.dsh/search-router.json

详细设置字段、Key 显示规则、回退策略见 docs/SETTINGS.md。

兼容性

DSH >=0.1.2-rc.1 <0.2
Host 侧运行时依赖：Node.js 内建模块 + @deepseek-ai/schemastery
Client 侧运行时依赖：React、@deepseek-ai/dsh-client-runtime、slots、settingsScope（web UI 自带）
注册 provider id：router
patch 会自动设置 web.searchProvider = router，保持 web.fetchProvider = http