前言¶
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 倉庫。