DeepSeek Harness (DSH) 的 Web profile 依賴本地服務運行。在 Windows 環境下，啓動這些服務並打開瀏覽器通常需要終端命令。DeepSeek Harness 的插件系統支持擴展。dsh-whale-desktop-launcher 插件解決了這一痛點，通過創建一個桌面快捷方式，自動在後臺啓動服務並在 Chromium 應用模式下打開 UI。
這是一個 Windows 桌面啓動器插件，由 0QwQ0 維護。它會在桌面生成一個帶鯨魚圖標（whale-girl）的 DeepSeek Harness.exe。點擊該圖標時，插件會在後臺啓動 DSH Web 服務，並使用 Chromium 的 --app 模式打開一個無標籤頁、無工具欄的緊湊型桌面窗口。
核心功能¶
- 一鍵啓動與重連：無需打開終端即可啓動或重連到
dsh web。 - 浮動進度窗口：啓動過程中會顯示一個懸浮窗口，展示各個階段（檢查服務、啓動服務器、等待就緒、打開 UI）。
- 系統托盤控制：程序運行時會在系統托盤駐留圖標。懸停查看狀態，雙擊打開 UI，使用菜單重啓服務或退出（退出會停止 DSH 服務）。
- 單實例模式：程序運行時再次雙擊桌面圖標，只會重新打開 UI 窗口，不會重複啓動服務。
- Chromium 應用模式：提供類似原生應用的窗口體驗。
- 資源捆綁：內置鯨魚女孩 PNG 和多分辨率 ICO 圖標。
- 參數捕獲：激活時會捕獲當前的 DSH 可執行文件路徑、參數和工作目錄，確保 npm checkout 和源碼檢查都能正常工作。
- 複用現有服務：如果端口上已有健康的服務，插件會複用它，而不是啓動新的實例。
- 就緒檢測：能夠識別
dsh-ui-auth登錄頁面作爲服務就緒的標誌，自動處理未認證請求的跳轉。 - 自動升級：升級時會在桌面替換舊的
DeepSeek Harness.exe。
安裝與啓用¶
- 使用以下命令安裝插件到 Web profile：
dsh plugin --profile web add github:0QwQ0/dsh-whale-desktop-launcher#v0.3.0
- 安裝完成後，重啓
dsh web一次，以便插件激活並寫入配置。
典型用法¶
安裝並重啓服務後，桌面上會出現 DeepSeek Harness.exe。雙擊該圖標即可啓動 UI。
注意事項與適用場景¶
- 環境要求：需要 Windows 10 或 11。需要 Node.js 22.19 或更高版本。需要已安裝 DSH Web profile。需要 Microsoft Edge 或 Google Chrome。
- 許可證：鯨魚女孩藝術作品使用 CC BY-NC-SA 4.0 許可證（僅限非商業使用）。源代碼使用 MIT 許可證。
- 卸載行爲：卸載插件時不會刪除桌面上的
DeepSeek Harness.exe文件，需要手動刪除。 - 生命週期腳本：安裝過程中不會運行
preinstall、install、postinstall或prepare腳本。 - 適用場景：適合需要在 Windows 桌面上快速訪問 DSH Web 界面的開發者，特別是習慣使用 Chromium 應用模式而非標準瀏覽器標籤頁的用戶。
結語¶
該插件通過封裝底層服務啓動邏輯，降低了 DSH 在 Windows 上的使用門檻，提供了類似原生應用的操作體驗。
