前言¶
DeepSeek Harness (DSH) 支持通过插件扩展功能。在开发或使用智能体时,Web 搜索是常见需求,但往往需要处理 API 密钥或复杂的代理配置。dsh-web-search-searxng 插件通过在本地托管 SearXNG 实例,解决了这些问题。
插件介绍¶
这是一个 Self-hosted SearXNG 元搜索引擎插件,为 DeepSeek Harness 提供联网搜索能力。插件由 Chaos-Paradox 维护,采用 MIT 许可证。
该插件的核心价值在于:
* 无需 API 密钥:默认无需配置密钥即可使用,保护隐私。
* 本地托管:在本地运行 SearXNG 服务,查询结果由你自己的实例转发至搜索引擎。
* 即插即用:直接在 DSH 侧边栏配置,无需手动管理 Docker 或 Python 环境。
安装与启用¶
安装此插件需要 DeepSeek Harness 0.2.1-alpha.2 及其标准 Web/base bundles。
- 在 DSH 的侧边栏中,打开 Plugins(插件)。
- 点击 Add plugin(添加插件)。
- 输入以下 GitHub URL:
https://github.com/Chaos-Paradox/dsh-web-search-searxng#v0.4.1 - 安装完成后,选择 Enable now(启用现在)。
也可以使用命令行安装,命令如下:
dsh plugin --profile <name> add https://github.com/Chaos-Paradox/dsh-web-search-searxng#v0.4.1
核心功能¶
- Self-hosted SearXNG metasearch:利用 SearXNG 作为元搜索引擎,聚合多个引擎结果。
- No API key required by default:默认无需 API 密钥,部分需要认证的实例可使用认证头。
- Configure directly in DSH sidebar:所有配置直接在 DSH 的侧边栏插件卡片中完成。
- Plugin-managed local SearXNG service:插件会自动下载并管理本地 Python 运行环境和依赖,无需用户手动安装 Docker 或 Python。
- Restores plugin routes:在官方路径覆盖路由时,可通过此功能恢复插件路由。
使用说明¶
安装并启用插件后,按照以下步骤进行初始化和配置:
- 在侧边栏打开 Plugins(插件)。
- 找到 SearXNG search 卡片。
- 首次使用时,点击 Prepare and start(准备并启动)。
- 插件会自动下载本地服务所需的环境和依赖。
- 等待状态变为 Ready。
- 在设置面板中选择搜索引擎和结果语言,点击保存。
- 之后即可直接进行搜索测试。
注意事项¶
在使用过程中,请注意以下配置细节:
- 默认本地端口为 0:默认配置下的本地端口是
0,由操作系统自动分配空闲端口,而不是8080。插件会自动更新有效端点,无需手动复制地址。 - 进程代理默认关闭:版本 0.4.1 默认关闭 DSH 进程代理。如需启用,需在卡片底部的红色风险区域直接输入主机和端口。启用时需查看风险声明并确认。
- 无用户 .env 写入:插件不会写入用户
.env文件,现有主机代理配置优先级更高。 - 更新与重启:更新插件后,必须完全重启 DSH 后端并刷新页面才能生效。
- 路由恢复:如果官方设置覆盖了路由,插件默认的回退开关无法阻止官方路径的费用。需使用 Restore plugin routes 来更改路由策略。
结语¶
dsh-web-search-searxng 插件为 DSH 提供了一个自托管、无需密钥的搜索解决方案,适合对隐私和网络延迟有要求的场景。更多细节可查看 GitHub 仓库。