前言¶

在 Windows 上運行 DeepSeek Harness 的 dsh web 時，服務啓動、停止、打開界面通常要靠終端命令。@gzmuldyxx/dsh-windows-tray 把這些操作集中到系統通知區域的托盤圖標上，減少來回敲命令的步驟。

這是什麼¶

這是一個 DeepSeek Harness 插件，包名是 @gzmuldyxx/dsh-windows-tray，維護者爲 GZMULDY。它提供一個常駐托盤鯨魚圖標，用於控制 dsh web：打開 Web 界面、啓動服務、停止服務、重啓服務和退出托盤。許可證爲 MIT。

核心功能¶

托盤圖標與狀態¶

• 在 Windows 系統通知區域常駐一個鯨魚圖標。
• 懸浮顯示當前狀態：運行中或已停止。

常用操作¶

• 左鍵單擊托盤圖標：啓動服務並打開 Web 界面。
• 右鍵菜單提供以下選項：
  1、打開界面：啓動並打開瀏覽器。
  2、啓動服務：後臺拉起 dsh web，且僅在未運行時啓動。
  3、停止服務：按端口 3080 終止 DSH 服務進程。
  4、重啓服務：先停止，再拉起。
  5、退出托盤：移除托盤圖標。

單實例保護¶

重複雙擊或重複安裝時，不會疊加出多個托盤圖標。

安裝與啓用¶

要求 Windows，並且已經安裝 DeepSeek Harness（dsh）。

先執行：

dsh plugin --profile web add @gzmuldyxx/dsh-windows-tray

這一步會把插件加入 web profile。

安裝後重啓 dsh web，托盤圖標會自動出現在系統通知區域。

如果當前沒有發佈 npm 包，也可以在本倉庫目錄內從源碼本地安裝：

dsh plugin --profile web add .

package.json 聲明 engines.node >=18，並聲明 peerDependencies 爲 @deepseek-ai/cordis ^4.0.1。

典型用法¶

經過上面的安裝步驟後，可以按下面方式使用托盤。

• 左鍵單擊托盤圖標：啓動服務 + 打開 Web 界面。
• 右鍵選擇“打開界面”：啓動並打開瀏覽器。
• 右鍵選擇“啓動服務”：後臺拉起 dsh web，未運行才啓動。
• 右鍵選擇“停止服務”：終止 DSH 服務進程，按端口 3080 定位。
• 右鍵選擇“重啓服務”：停止後再拉起。
• 右鍵選擇“退出托盤”：移除托盤圖標。

如果需要覆蓋默認行爲，可以設置環境變量。

覆蓋托盤打開的 Web 地址：

DSH_WEB_URL=http://127.0.0.1:3080

默認值是 http://127.0.0.1:3080。

啓動托盤時不自動打開瀏覽器：

DSH_TRAY_NOOPEN=1

設置爲任意值即可。

指定源碼 checkout 目錄：

DSH_CHECKOUT=<源碼 checkout 目錄>

默認值是 process.cwd()。

適用場景與注意¶

適合在 Windows 桌面長期運行 dsh web，並且希望從托盤快速控制服務的人。

注意：

• 停止服務依賴端口 3080 定位 DSH 服務進程；如果實際服務端口不是 3080，停止行爲可能不符合預期。
• 插件會啓動/停止 dsh web 進程，並以當前 dsh 進程權限運行；安裝前應檢查源碼與許可證。
• 安裝後需要重啓 dsh web。

獲取¶

GitHub：

https://github.com/GZMULDY/dsh-windows-tray.git

插件線索中的目錄頁地址（未作爲已覈實資料確認）：

https://www.skillhub.cn/plugins/GZMULDY/dsh-windows-tray