dsh-web-search-multi
> 多源聚合与免费额度 Web 搜索插件（附带 Web GUI 可视化管理面板），适用于 DeepSeek Harness (DSH)。
English | 简体中文
  
---
1. 概述 (Overview)
dsh-web-search-multi 为 DeepSeek Harness 提供了全能的多源 Web 搜索支持与自动故障降级能力：
- 国内免 Key 极速直连：内置 360 搜索（实时新闻热点推荐）、Bing 必应与百度搜索，无需任何 API Key，国内与海外环境均可极速直连。
- 主流 AI 免费额度：支持 Tavily（1,000 次/月）、Brave Search（2,000 次/月）、Serper/Google（注册赠送 2,500 次）、博查 AI。
- 私有化与开源自建：支持接入 SearXNG 实例，支持访问 Token 鉴权。
- 海外免 Key 兜底：集成 DuckDuckGo 搜索。
- 内置可视化设置面板：在 DSH Web GUI 的设置中心中提供独立的「多源 Web 搜索」页面，支持配置持久化、实时自动保存与在线搜索测试。
- 安全合规存储：敏感 Key 统一持久化至
~/.dsh/.credentials.yaml（POSIX 0600 安全隔离），常规设置持久化至~/.dsh/settings.yaml。
---
2. 兼容性 (Compatibility)
- Node.js:
>= 20.0.0 - DeepSeek Harness: 兼容 mainline
v0.1.0+ - 已验证系统: Linux / macOS / Windows
---
3. 安装与挂载 (Install)
作为 DSH 标准 Profile Bundle 组合包，安装一步到位：
dsh plugin --profile web add github:cinob/dsh-web-search-multi> 提示：作为 Bundle 组合包，插件自带的 cordis.patch.yml 会自动挂载并激活多源搜索服务，无需在 profiles/web/cordis.patch.yml 中重复手动 insert。
卸载插件
dsh plugin --profile web remove dsh-web-search-multi---
4. 快速上手 (Quick Start)
1. 启动 Web 实例： ``bash dsh web ` 2. 浏览器打开 http://127.0.0.1:3080`，点击左下角 「设置」 ➔ 「多源 Web 搜索」。 3. 选择首选搜索引擎（默认推荐「自动策略」）。 4. （选填）填入你的 Tavily、Brave、Serper、博查或 SearXNG Token，点击保存并实时在线测试。
---
5. 配置说明 (Configuration)
环境变量与凭据映射
| 凭据 / 变量名 | 说明 |
|---|---|
TAVILY_API_KEY | Tavily API Key (1,000 次/月) |
BRAVE_API_KEY | Brave Search API Key (2,000 次/月) |
SERPER_API_KEY | Serper Google API Key (2,500 次) |
BOCHA_API_KEY | 博查 AI 搜索 Key |
SEARXNG_URL | SearXNG 实例 URL (例如 https://s.655443.xyz) |
SEARXNG_TOKEN | SearXNG 认证 Token (选填) |
---
6. 权限与安全披露 (Permissions & Disclosures)
- 风险等级:
low - 网络访问: 仅向用户选定或配置的搜索引擎端点发起外网请求。
- 凭据管理: 敏感密钥通过
ctx.credentials安全加密持久化至~/.dsh/.credentials.yaml，非机密配置保存在~/.dsh/settings.yaml，绝不上传第三方服务器。
---
7. 本地开发与测试 (Development)
# 克隆仓库
git clone https://github.com/cinob/dsh-web-search-multi.git
cd dsh-web-search-multi
# 构建产物
npm run build
# 运行单元测试
npm test---
8. 开源协议 (License)
MIT License.