dsh-tray-launcher：DeepSeek Harness 的 Windows 桌面托盤啓動器

前言¶

DeepSeek Harness（DSH）默認在終端前臺運行 dsh web，必須保留一個 cmd/PowerShell 窗口，誤關窗口服務即停。本工具將其轉換爲標準的 Windows 托盤應用：雙擊快捷方式無窗口啓動，系統托盤常駐圖標，Harness 就緒後自動打開瀏覽器；托盤菜單管理界面與日誌，「退出」即完整停止（先停 Harness、再關托盤）。

是什麼¶

dsh-tray-launcher 是 DeepSeek Harness 的 Windows 桌面托盤啓動器。由 fancr-code 維護，採用 MIT 許可證。

它不依賴 Electron 等桌面殼運行時，而是基於純 PowerShell 核心腳本（約 30KB）配合一行 VBS 實現。相比打包的桌面客戶端，優勢在於體積小、乾淨，無後臺殘留進程。內存佔用經過優化，實測常駐約 55MB 工作集 / 84MB 私有提交。

核心功能¶

低佔用：純 PowerShell + VBS，不加載 Electron 運行時，定期清理工作集。
系統托盤常駐：無窗口運行，托盤圖標 + 氣泡提示（啓動、運行中、已停止），Harness 意外退出自動收起。
無窗口啓動：不彈 cmd/控制台，stdout/stderr 落盤日誌。
自動打開瀏覽器：後臺輪詢端口，Harness 一監聽就自動打開 Web GUI。
單實例保護：互斥鎖 + 端口檢測，重複雙擊快捷方式不會重複啓動，只會喚起界面。
多圖標切換：預設梁祖、鯨魚娘、DeepSeek 三款圖標，托盤右鍵「切換圖標」一鍵更換，托盤與桌面快捷方式圖標同步更新。
開機自啓：安裝時通過 -Autostart 參數註冊，或通過托盤右鍵菜單一鍵開關。
內置用量儀表：隨包攜帶 dsh-plugin-usage-meter，安裝時自動註冊，托盤菜單顯示當前版本並可一鍵更新。
自更新：托盤「更新啓動器」菜單一鍵 npm i -g 更新自身。
可作爲 dsh 插件安裝：通過 dsh plugin add 安裝後，托盤隨 Harness 自動啓動/退出。

安裝與啓用¶

前置條件¶

Windows 10 / 11
Windows PowerShell 5.1
已安裝 DeepSeek Harness CLI（dsh web 可正常啓動）
已安裝 Node.js（版本 >= 18）

全局安裝¶

npm install -g dsh-tray-launcher

安裝後執行以下命令啓動：

# 托盤模式（無窗口）
dsh-tray

# 控制台模式（日誌直出終端）
dsh-tray --console

作爲 DSH 插件安裝¶

dsh plugin --profile web add dsh-tray-launcher

此方式下，托盤隨 Harness 自動啓動/退出，配置與日誌保存在 %DSH_HOME%\dsh-tray。

典型用法¶

操作	效果
`dsh-tray`	無窗口啓動；托盤出圖標 + 氣泡；端口就緒自動開瀏覽器
`dsh-tray --console`	控制台模式，前臺運行、日誌直出終端
雙擊托盤圖標	打開界面
托盤「退出」	停止 harness + 關閉托盤（全部退出）
托盤「切換圖標」	彈出子菜單切換梁祖 / 鯨魚娘 / DeepSeek / 自定義圖標

配置¶

安裝器在安裝目錄（%LOCALAPPDATA%\Programs\DSHTray\）生成 dsh-tray.config.json，字段均爲可選：

{
  "dshBin":   "C:\\...\\node_modules\\@deepseek-ai\\dsh\\lib\\bin.js",
  "node":     "C:\\Program Files\\nodejs\\node.exe",
  "url":      "http://127.0.0.1:3080",
  "icon":     "liangzu",
  "shortcut": "C:\\Users\\<you>\\Desktop\\DeepSeek Harness.lnk",
  "cwd":      "C:\\Users\\<you>"
}

dshBin / node：缺省時按「npm 全局 → npx 緩存 → PATH → 常見路徑」順序自動探測。
icon：支持 liangzu（默認）、whale-girl、deepseek 或自定義 .ico 路徑。
shortcut：桌面快捷方式路徑，用於同步圖標。

注意事項¶

退出行爲：點擊托盤「退出」會停止 Harness 並退出托盤（全退）。
圖標素材歸屬：梁祖畫像源自相關開源項目，鯨魚娘幀源自相關開源項目，DeepSeek 鯨魚 logo 爲 DeepSeek。
已知限制：退出時通過端口占用者與「命令行含 dsh 的 node.exe 進程」定位並結束 Harness；若同時跑着其他命令行帶 dsh 字樣的 node 進程，可能被一併結束。

結語¶

dsh-tray-launcher 解決了 DSH 在 Windows 上需要常駐終端窗口的痛點，提供了一個輕量級、零運行時的托盤解決方案。適合需要在後臺常駐 Harness 並通過瀏覽器訪問 Web UI 的用戶。

GitHub 倉庫