dsh-search-switcher：DeepSeek Harness 搜索引擎快速切換

在 DeepSeek Harness 中，切換搜索引擎通常需要進入設置頁面，或者輸入斜槓命令。如果網絡環境限制了 DeepSeek 官方接口，這一過程會變得繁瑣。dsh-search-switcher 插件將搜索引擎切換器直接渲染在 Composer 輸入區的模型選擇器左側，提供即時的操作入口。

插件定位¶

該插件由 Hudson-Junior-Wang 維護，基於 MIT 許可證開源。它是一個緊湊型工具，旨在解決在 DeepSeek Harness composer 中快速更改首選搜索引擎的問題。

安裝與啓用¶

安裝插件需要通過 Harness 的插件 CLI 執行。同時，該插件依賴 dsh-free-search 插件（版本 >= 0.4.7）來提供設置橋接和搜索提供商。

安裝插件：

    dsh plugin --profile web add https://github.com/Hudson-Junior-Wang/dsh-search-switcher.git

安裝或確認 dsh-free-search 已安裝：

    dsh plugin --profile web add https://github.com/DDDMUC/dsh-free-search.git

安裝完成後，重啓 Harness Web 主機或刷新 UI。控制面板將出現在模型選擇器的左側。

核心功能¶

即時切換：通過 conversation.input.right 注入控制組件，位於模型選擇器左側。
引擎列表：提供可滾動的引擎列表，當前選中的引擎會高亮顯示。
讀寫配置：通過 loopback bridge 讀取並寫入 free-search.provider 設置。
支持的引擎：兼容 dsh-free-search 暴露的十個引擎，包括 DuckDuckGo HTML、DuckDuckGo Lite、Bing、AnySearch AI、SearXNG、Exa、Tavily、Keenable、Perplexity 和 DeepSeek Official。
視覺適配：使用 Harness 的主題變量進行渲染，保持界面一致性。
全鍵盤支持：
- 箭頭鍵：打開菜單並在引擎間移動。
- Home/End：跳轉至列表首尾項。
- Enter/Space：激活當前選中的引擎。
- Escape：關閉菜單並恢復焦點。

兼容性說明¶

使用本插件前，需注意以下環境要求與已知問題：

Node.js 版本：需要 DeepSeek Harness Web profile 運行在 Node.js 20 或更高版本。
dsh-free-search 版本：要求 dsh-free-search 版本 >= 0.4.7。
特定版本兼容性問題：
在 dsh-free-search 0.4.22 版本中，如果 Harness 的 dsh-settings 版本 <= 0.1.2-alpha.1（舊運行時），插件將無法加載。這是因爲舊運行時移除了 installSection 方法，導致 free-search 命名空間未被暴露。
- 解決方案：將 Harness 升級至包含 @deepseek-ai/dsh-settings >= 0.1.2-alpha.2 的版本；或在舊運行時下修補本地安裝的 dsh-free-search 0.4.22；或者將 dsh-free-search 降級至 0.4.21 及以下。

適用場景與限制¶

典型用法：
* 在網絡環境屏蔽 api.deepseek.com 時，無需離開當前對話，點擊切換器即可回退到 Bing、DuckDuckGo 或 SearXNG。
* 快速在多個本地或第三方搜索引擎之間切換，無需記憶或輸入斜槓命令。

限制：
* 該插件僅負責切換首選提供商，不會繞過任何提供商的認證、API 密鑰要求或網絡限制。
* 它不提供搜索結果預覽，僅控制數據源。

總結¶

dsh-search-switcher 通過將控制權下放至 Composer 輸入區，優化了 DeepSeek Harness 的搜索體驗。對於需要頻繁切換網絡環境或搜索引擎的用戶，它提供了一條直接、高效的路徑。

項目主頁: https://github.com/Hudson-Junior-Wang/dsh-search-switcher
技能星目錄: https://www.skillhub.cn/plugins/Hudson-Junior-Wang/dsh-search-switcher