前言¶

DeepSeek Harness（DSH）通常通過命令行運行 dsh web 來啓動 Web 服務。這需要保持終端窗口打開，或手動在後臺管理進程。對於需要常駐後臺或希望通過圖形界面快速控制服務的場景，這種交互方式並不直觀。

DSH Tray 旨在解決這一問題。它是一個 Windows 系統托盤啓動器，將 DSH Web 服務無頭化運行，並提供托盤圖標控制。

這是什麼¶

DSH Tray 是一個由 nxz1026 維護的 Windows 客戶端插件。它通過 PowerShell 腳本創建系統托盤通知圖標，用於管理 DeepSeek Harness Web 服務的生命週期。

該工具不依賴圖形化安裝程序，通過腳本直接運行，允許用戶在不佔用終端的情況下啓動、停止、重啓服務，並查看日誌。

核心功能¶

DSH Tray 提供以下能力：

1. 系統托盤控制：通過托盤圖標控制服務的啓動、停止和重啓。
2. Web UI 訪問：直接通過托盤菜單打開 Web UI。
3. 日誌查看：在 Windows Terminal 中實時查看服務日誌。
4. 開機自啓：支持配置系統登錄時自動啓動服務。
5. 遠程模式：支持通過 SSH 連接雲主機，在遠程啓動服務並通過本地端口隧道訪問。

安裝與啓用¶

可以通過 DSH 的插件命令進行註冊，也可以直接運行腳本。

1. 註冊爲插件：
   使用以下命令將插件註冊到 web 配置文件中：

    dsh plugin --profile web add https://github.com/nxz1026/dsh-tray

2. 直接運行：
   下載或克隆倉庫後，直接運行腳本：

    powershell -File assets\dsh-tray.ps1

典型用法¶

1. 準備環境：
   確保系統爲 Windows，且 node 命令在系統路徑（PATH）中可用。

2. 配置（可選）：
   複製配置示例文件並進行編輯：

    Copy-Item assets\dsh-tray.config.example.ps1 assets\dsh-tray.config.ps1

編輯 `assets\dsh-tray.config.ps1`，可配置以下項：
*   `$port`：服務端口（默認 `3080`）。
*   `$startCommand`：啓動 `dsh web` 的具體命令（需在 `PATH` 中）。
*   `$autoStart`：是否在啓動托盤時自動啓動服務。
*   `$pollIntervalMs`：托盤檢查服務狀態的間隔（默認 `3000`）。
*   `$workDir`：DeepSeek Harness 倉庫根目錄，用於解析依賴路徑。
*   `$mode`：運行模式，`local` 爲本地，`remote` 爲 SSH 遠程。

3. 啓動服務：
   運行腳本後，服務將靜默啓動，托盤圖標出現。
   若需通過 VBS 啓動以避免控制台窗口：

    wscript.exe dsh-tray.vbs

4. 使用遠程模式：
   在配置文件中將 $mode 設爲 'remote'，並填寫 $sshHost、$sshKey、$remoteStartCommand。啓動後，服務會在雲主機上運行，並通過 SSH 隧道映射到本地端口，實現本地訪問。

適用場景與注意¶

• 適用場景：需要在 Windows 系統後臺靜默運行 DSH 服務的開發者，或需要通過圖形界面快速管理服務狀態的用戶。
• 注意：
  • 僅支持 Windows 系統。
  • 默認假設服務端口爲 3080，若修改需同步調整。
  • 這是一個獨立工具，並非 DeepSeek 官方產品。
  • 權限說明：插件以當前 DSH 進程權限運行，開機自啓功能依賴用戶 Run 註冊表項。
  • 路徑依賴：若倉庫路徑移動，需重新切換開機自啓選項以更新註冊表路徑。

結尾¶

DSH Tray 將命令行工具轉化爲可視化的系統托盤應用，降低了 DSH 服務的使用門檻。更多細節和最新更新，可訪問插件目錄或查看 GitHub 倉庫。