前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的架構理念。對於需要在瀏覽器端和桌面端之間切換的開發者，管理獨立的 Tauri 應用實例、快捷方式以及退出流程通常需要手動操作。DSH Tauri Launcher 插件將桌面端的啓停、退出確認及快捷方式管理抽象爲標準的 Web 插件，用戶可直接在 DSH 的設置面板中完成這些操作，無需脫離 Web 界面。
這是什麼¶
DSH Tauri Launcher 是一個 DSH 插件，由 cilis 維護。它解決了在 Web 環境下管理 Tauri 桌面應用實例的問題，通過插件化的方式實現桌面啓動開關、快捷方式聯動和狀態可視。
核心功能¶
該插件提供以下能力：
- 桌面端啓動開關：在 Web 設置面板中一鍵啓動或退出桌面應用，點擊後立即反饋，秒級同步狀態。
- 快捷方式聯動：開啓時自動創建桌面快捷方式，關閉時自動刪除；運行中支持手動補建。
- 關閉確認彈窗：關閉前彈出確認框，並提示快捷方式將被刪除。
- 狀態可視：顯示運行中（綠色）、已停止（灰色）、狀態未知（黃色）或錯誤狀態，並附帶診斷信息。
- 深色模式適配：界面顏色適配 DSH 主題令牌，支持深淺色自動切換。
- 設置導航顯示器圖標：替換默認齒輪圖標，使用矢量繪製，任意縮放保持銳利。
安裝與啓用¶
安裝命令如下。請將命令中的 <profile> 替換爲你實際使用的配置檔名稱（例如 web）：
dsh plugin --profile web add github:cilis/dsh-tauri-launcher
安裝完成後，重啓 DSH Web 進程，在設置面板中即可看到「桌面啓動」分區。通過 dsh --profile web --dump-config 命令可以驗證插件是否已生效。
典型用法¶
- 進入 DSH 設置 → 桌面啓動。
- 配置參數：
launcherExe：桌面應用 exe 絕對路徑，留空則自動探測。launcherDirs：候選 exe 目錄列表，留空則使用內置默認候選。freshSecs：心跳“新鮮窗口”的秒數，須大於心跳寫入週期。
- 點擊開關即可喚起或關閉 Tauri 桌面應用。
適用場景與注意¶
- 平臺限制：目前僅支持 Windows。Linux 和 macOS 尚在規劃中。
- 快捷方式命名：快捷方式文件名由插件與桌面應用共用（
DeepSeek Harness.lnk），不存在自定義名稱配置。 - 開發維護：修改
launcher/src-tauri下的 Rust 源碼後，必須重新構建dsh-launcher.exe，否則 npm 包內 exe 與源碼會不一致。 - 依賴機制：插件依賴標記文件協議控制桌面應用（
.dsh-heartbeat用於探測運行狀態，.dsh-quit用於優雅退出）。
結語¶
DSH Tauri Launcher 將桌面應用的管理流程標準化、插件化，降低了 Web 與桌面端集成的門檻。該插件通過共享心跳文件和快捷方式，確保了狀態同步的準確性。更多技術細節及源碼，請參考插件目錄或 GitHub 倉庫。
