前言¶
DeepSeek Harness（DSH）默認在瀏覽器中運行。dsh-desktop-shell 插件通過將 WebUI 轉換爲獨立的桌面應用來解決這一問題。它會在用戶目錄下生成一個便攜啓動器，創建桌面和開始菜單快捷方式，並接管 DSH 後端的運行。
核心功能¶
該插件通過 WebView2 窗口實現獨立應用體驗，具備以下能力：
- 獨立窗口：複用系統 WebView2 運行時，無瀏覽器地址欄與標籤頁。
- 關閉即最小化到托盤：關閉窗口僅隱藏，必須通過托盤菜單“退出”才能停止後端。
- 無痕啓動：後端靜默運行，不彈控制台窗口，日誌輸出至指定目錄。
- 就緒門控：界面不會提前加載，需等待後端打印認證 URL 後才進入，避免閃現 404。
- 零 Electron 依賴：載荷約 1.2MB，不引入龐大的 Electron 運行時。
- 調試模式：提供獨立的調試快捷方式，後端以可見控制台運行，方便查看報錯。
- 看門狗與自動接管：後端意外退出會自動拉起；支持接管外部啓動的 DSH 後端。
- 設置內控制：在設置 → 通用設置 → DSH 桌面外殼 中提供安裝、修復、清理及自啓開關。
安裝與前置條件¶
前置條件：
* 系統：Windows 10/11 (x64)。
* 運行時：WebView2（通常已預裝），Node.js >= 22，DSH >= 0.1.5-rc.1。
* 權限：不需要管理員權限，安裝文件位於用戶目錄。
安裝步驟：
在終端執行以下命令安裝插件：
dsh plugin --profile web add dsh-desktop-shell
安裝後必須重啓 DSH 使插件生效。重啓後，可在設置 → 通用設置 → DSH 桌面外殼 中確認安裝狀態。
使用方法¶
檢查狀態¶
可以通過接口檢查安裝狀態：
curl.exe http://127.0.0.1:3080/api/dsh-desktop/status
托盤操作¶
啓動器會在系統托盤常駐。右鍵托盤圖標可進行以下操作：
* 打開界面：恢復窗口。
* 重啓後端 / 以調試模式重啓：重啓 DSH 後端。
* 接管外部後端：將非託管的後端進程納入啓動器管理。
* 查看日誌 / 配置 / 數據目錄：快速定位相關文件。
設置操作¶
在設置界面中，針對“DSH 桌面外殼”行可進行：
* 安裝 / 修復：重新落地文件並刷新配置。
* 重建快捷方式：更新桌面、開始菜單快捷方式。
* 開啓 / 關閉登錄自啓：默認關閉，需手動開啓。
* 清理安裝：刪除快捷方式與用戶目錄下的插件文件。
* 重啓後端：由啓動器託管重啓。
安裝後文件¶
插件安裝後，會在 %USERPROFILE%\dsh-desktop 目錄下生成以下內容：
- 可執行文件：
DSHLauncher.exe（約 90KB）。 - 依賴庫：
Microsoft.Web.WebView2.*.dll、WebView2Loader.dll。 - 源碼與校驗：
DSHLauncher.cs、build-icons.mjs、SHA256SUMS.txt。 - 配置與日誌：
launcher.config.json、preferences.json、logs\dsh-web.log。 - 快捷方式：桌面與開始菜單的
.lnk文件。
清理與卸載¶
卸載插件：
dsh plugin --profile web remove dsh-desktop-shell
卸載後，建議在設置中點擊“清理安裝”，以刪除快捷方式和 %USERPROFILE%\dsh-desktop 目錄。
注意：若插件仍啓用，宿主下次啓動會自動重新安裝。要永久移除，請先卸載插件或設置環境變量 DSH_DESKTOP_NO_AUTOINSTALL=1。
生態背景¶
DSH 採用插件化架構。本插件由開發者 RINGOLINK 維護，符合 MIT 許可證。所有文件與行爲均由插件自身管理，不改動 DSH 本體。
