前言¶
在 Windows 上運行 DeepSeek Harness（dsh）的 web 服務時，常見的操作包括啓動服務、打開 Web UI、查看日誌、重啓服務和退出服務。如果這些操作都要回到命令行窗口完成，使用路徑會比較分散。
@7dgroup/dsh-7d-tray-win 是一個面向 Windows 的 DSH 系統托盤插件。dsh web 運行時，它會顯示 DeepSeek 鯨魚系統托盤圖標；服務停止後，托盤圖標會在 3 秒內自動消失。同時，它還會自動維護桌面上的 DSH.lnk 靜默啓動器，用於在無窗口狀態下啓動 dsh web 並打開瀏覽器。
這是什麼¶
@7dgroup/dsh-7d-tray-win 是 dsh web 的 Windows 專屬託盤插件，適合需要把 DSH web 服務放在系統托盤中管理的場景。
它提供以下基礎能力：
dsh web運行時顯示 DeepSeek 鯨魚托盤圖標。- 服務停止後，托盤圖標自動消失。
- 雙擊托盤圖標打開 Web UI，端口從運行中的 webserver/cordis 運行時讀取，不硬編碼端口。
- 右鍵托盤圖標支持打開 Web UI、打開日誌目錄、重啓服務、退出服務。
- 自動維護桌面靜默啓動器
DSH.lnk。 - 在非
win32平臺自動跳過，不創建托盤或快捷方式。
該插件以純 Cordis composition bundle 形式提供，僅通過 cordis.patch.yml 修改 profile，不覆蓋官方 DSH 包文件。
倉庫地址：
https://github.com/7dgroup-ai/dsh-7d-tray-win
許可證：
MIT
peerDependencies 要求：
@deepseek-ai/cordis ^4.0.1
核心功能¶
托盤圖標生命週期¶
dsh web 運行期間，插件會在系統托盤中顯示 DeepSeek 鯨魚圖標。無論 dsh web 是通過命令行、腳本還是桌面快捷方式啓動，只要服務在運行，托盤圖標就會出現。
當服務停止後，托盤圖標會在 3 秒內自動消失。
打開 Web UI¶
雙擊托盤圖標可以打開 Web UI。插件會從運行中的 webserver/cordis 運行時讀取端口，因此不依賴硬編碼端口，也適配自定義端口配置。
右鍵菜單中的 Open DSH Web 也執行相同動作：打開 Web UI，端口自動檢測。
日誌與服務管理¶
右鍵托盤圖標可以執行以下操作：
Open DSH Web：打開 Web UI。Open log folder：打開日誌目錄。Restart service：重啓服務。Exit：退出服務並關閉托盤。
選擇 Restart service 後，插件會先彈出確認，然後終止服務器進程樹，並通過 npx 重啓 dsh web。
桌面靜默啓動器¶
插件會自動維護桌面上的 DSH.lnk。雙擊 DSH.lnk 可以在無窗口狀態下啓動 dsh web，並自動打開瀏覽器。
需要注意的是，DSH.lnk 本身不顯示托盤；托盤圖標由插件在 dsh web 運行時提供。
Windows-only 行爲¶
該插件僅面向 Windows。在非 win32 平臺上會自動跳過，不會創建托盤圖標，也不會創建桌面快捷方式。
安裝與啓用¶
安裝前，環境需要滿足以下要求：
Windows 10/11
Node ^22.19.0 || >=24.0.0
pnpm 10+
PowerShell
首次運行還需要 .NET Framework 4，用於編譯靜默啓動器。如果系統中缺少 csc.exe，桌面快捷方式功能不可用，但托盤功能仍可使用。
如果目標運行命令是 dsh web，通常將插件安裝到 web profile。下面這條命令會把插件安裝到 web profile：
dsh plugin --profile web add @7dgroup/dsh-7d-tray-win
如果插件是本地目錄，例如用於開發或測試，也可以從本地路徑安裝：
dsh plugin --profile web add C:\path\to\dsh-7d-tray-win
安裝完成後，啓動 dsh web：
dsh web
經過上面的步驟，托盤圖標和桌面 DSH.lnk 會自動生效。
典型用法¶
啓動 dsh web 並查看托盤¶
安裝插件後，直接啓動 dsh web：
dsh web
啓動後，系統托盤會出現 DeepSeek 鯨魚圖標。此時桌面會自動維護 DSH.lnk。
雙擊桌面 DSH.lnk¶
雙擊桌面上的 DSH.lnk 後：
- 不顯示命令行窗口。
- 在後臺啓動
dsh web。 - 自動打開瀏覽器到 Web UI。
- 系統托盤出現 DeepSeek 鯨魚圖標。
雙擊托盤圖標¶
雙擊系統托盤中的 DeepSeek 鯨魚圖標，會打開當前 dsh web 的 Web UI。插件會從運行中的 webserver/cordis 運行時讀取端口，不硬編碼端口。
使用右鍵菜單¶
右鍵托盤圖標可以看到以下菜單項：
Open DSH Web
Open log folder
Restart service
Exit
其中：
Open DSH Web打開 Web UI。Open log folder打開日誌目錄。Restart service確認後終止當前服務進程樹，並通過npx重啓dsh web。Exit停止dsh web並關閉托盤。
適用場景與注意¶
這個插件適合以下使用者：
- 在 Windows 10/11 上運行
dsh web。 - 希望把服務狀態放進系統托盤。
- 希望有一個無窗口的桌面啓動入口。
- 希望從托盤直接打開 Web UI、日誌目錄、重啓服務或退出服務。
使用前需要注意以下幾點：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 該插件是 Windows-only 插件，非
win32平臺會自動跳過。 DSH.lnk只負責靜默啓動dsh web，本身不顯示托盤。- 每次
dsh web啓動時，插件會用自身最新資產刷新%LOCALAPPDATA%\dsh-7d-tray-win中的資產文件，因此不要在該目錄中存放自定義持久文件。 - 首次運行需要
.NET Framework 4編譯靜默啓動器；缺少csc.exe時，桌面快捷方式不可用，但托盤仍可用。 - 插件僅通過
cordis.patch.yml修改 profile，不覆蓋官方 DSH 包文件。
鏈接¶
GitHub 倉庫：
https://github.com/7dgroup-ai/dsh-7d-tray-win
