dsh-wsl-launcher：在 WSL 中啓動 DeepSeek Harness Web 的 Windows 桌面快捷方式

前言¶

DeepSeek Harness (DSH) 採用插件化架構，支持在本地環境運行。當 dsh web 實例運行在 WSL（Windows Subsystem for Linux）中時，通過 Windows 桌面訪問該 UI 會涉及繁瑣的終端操作：打開終端、切換到 WSL、運行 dsh web、等待啓動、切換瀏覽器並輸入 URL。這種工作流在頻繁調試時效率較低。

dsh-wsl-launcher 插件通過在 Windows 桌面創建一個快捷方式，將上述操作封裝爲一個雙擊動作，實現了在 Windows 桌面直接訪問 WSL 中運行的 DeepSeek Harness Web UI。

插件介紹¶

dsh-wsl-launcher 是一個 Windows 桌面啓動器，用於啓動運行在 WSL 中的 DeepSeek Harness Web UI。它由開發者 rqzhao1 維護，遵循 MIT 許可證。

該插件主要解決“在 Windows 環境下啓動和訪問 WSL 中的 DSH Web 服務”這一痛點，通過桌面快捷方式和命令行工具簡化交互流程。

核心功能¶

該插件提供以下核心能力：

雙擊啓動：在 Windows 桌面生成一個快捷方式（圖標爲黑鯨），雙擊即可觸發 WSL 啓動並打開 Web UI，無需打開終端。
自動後臺運行：插件會在後臺啓動 dsh web 服務，控制台窗口可關閉而不影響服務運行。
冪等性設計：如果 Web UI 端口已監聽，插件僅打開瀏覽器；多次雙擊不會產生衝突或錯誤。
模型工具集成：註冊了 wsl_launcher 模型工具，支持在 DSH 會話中通過命令進行安裝、狀態檢查、啓動和卸載管理。

安裝與啓用¶

安裝前需確保已安裝 DSH 並配置好 profile（例如 web profile）。

在終端中執行以下命令安裝插件：

dsh plugin --profile web add dsh-wsl-launcher

安裝完成後，重啓 dsh web。插件會自動在 WSL 中創建啓動腳本和圖標，並在 Windows 桌面生成快捷方式。

使用方式¶

安裝並重啓後，可通過以下方式使用：

桌面快捷方式：在 Windows 桌面找到名爲“DeepSeek Harness Web”的快捷方式，雙擊即可啓動服務並打開瀏覽器。
命令行工具：在 DSH 的會話中，可以調用 wsl_launcher 工具：
- 檢查狀態：wsl_launcher status（用於檢測 WSL 是否可用及端口監聽情況）。
- 打開服務：wsl_launcher open（直接在瀏覽器中打開 Web UI）。
- 安裝/卸載：wsl_launcher install / wsl_launcher uninstall（用於管理插件自身的文件和快捷方式）。

適用場景與注意¶

適用場景：需要在 WSL 環境中使用 DeepSeek Harness 進行開發或調試，但習慣使用 Windows 桌面進行操作的用戶。

注意事項：
1. 環境依賴：需在 dsh 0.1.1-rc.2 版本上驗證通過；Host 端需安裝 Node.js (>=20)。
2. WSL 要求：必須啓用 WSL1 或 WSL2，且 Windows 互操作性功能已開啓（默認開啓）。
3. 權限與安全：插件會在 WSL 和 Windows 端寫入文件，但不會讀取、存儲或發送任何憑證，僅進行本地端口探測和瀏覽器調用。

結尾¶

dsh-wsl-launcher 通過封裝 WSL 啓動邏輯，降低了在 Windows 環境下使用 DeepSeek Harness 的門檻。若你需要在 WSL 中管理 DSH 實例，該插件提供了一個輕量級的桌面入口。

插件詳情可查閱：GitHub