前言¶
DeepSeek Harness (DSH) 在 WSL 環境中運行時，通常需要通過終端訪問。dsh-wsl-tray 插件解決了這一問題，它爲運行在 WSL 中的 DSH 提供了 Windows 桌面快捷方式和系統托盤啓動器，使開發者可以在桌面端直接操作。
插件介紹¶
dsh-wsl-tray 是一個 DeepSeek Harness (DSH) 插件，爲 WSL 部署提供桌面快捷方式和系統托盤啓動器。
* 維護者：liyu34
* 許可證：MIT
* 定位：客戶端插件
核心功能¶
該插件包含以下核心能力：
1. 桌面快捷方式：雙擊桌面上的 “DeepSeek Harness” 快捷方式，可在後臺啓動 DSH 或複用已有實例。
2. 系統托盤菜單：托盤圖標右鍵提供一系列操作：打開網頁、重新生成快捷方式、重啓服務、暫停/恢復守護進程、退出。
3. 看門狗守護進程：自動探測 DSH 狀態，檢測失敗時自動重啓。達到最大失敗次數後暫停，恢復運行或 DSH 正常後自動繼續。
4. 配置卡片：在 DSH Web 的插件配置卡片中，可查看實時狀態和看門狗日誌，並提供重建快捷方式的按鈕。
5. 無控制台窗口：通過 wscript.exe 和 VBS 啓動，進程運行時無控制台窗口乾擾。
安裝¶
安裝命令如下：
dsh plugin --profile web add dsh-wsl-tray
安裝後，重啓 dsh web 並在設置中找到 WSL 桌面與托盤 卡片。
使用說明¶
- 啓動：雙擊桌面快捷方式啓動 DSH。
- 打開網頁：雙擊托盤圖標或通過托盤右鍵菜單打開 DSH 網頁。
- 重建快捷方式：如果快捷方式失效，通過插件配置卡片點擊重建，無需手動操作 WSL。
工作原理¶
插件通過以下鏈路實現功能：
1. 啓動鏈路：桌面快捷方式指向 wscript.exe，後者執行 VBS 腳本啓動隱藏的 PowerShell 托盤進程，托盤進程通過 wsl.exe 在 WSL 中啓動 start.sh。
2. 看門狗邏輯：托盤進程內部運行一個守護進程，定時探測 DSH Web URL。探測失敗達到閾值（默認 3 次）後觸發重啓。連續重啓失敗達到上限（默認 3 次）後進入暫停狀態，直到手動恢復或 DSH 恢復正常。
3. 日誌記錄：看門狗的探測結果、重啓動作及狀態變更均記錄在 watchdog.log 中。
注意事項¶
- 環境要求：僅支持 WSL 環境，非 WSL 主機無法使用。
- 版本要求：DSH web 版本需在 0.1.0-rc.7 或更新。
- 系統依賴：系統需安裝
wscript.exe、powershell.exe和wsl.exe。 - 進程關係：看門狗依附於托盤進程，退出托盤即停止看門狗和 DSH 實例。
