前言¶

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 仓库。