前言¶

在 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