cinob/dsh-web-search-multi

dsh-web-search-multi

多源聚合与免费额度 Web 搜索插件（附带 Web GUI 可视化管理面板），适用于 DeepSeek Harness (DSH)。

license
GitHub
dsh-plugin

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 实例：
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.
- 仓库地址: https://github.com/cinob/dsh-web-search-multi