nxz1026/dsh-tray

Awesome DSH Plugin
DSH 托盘

一个用于 DeepSeek Harness Web 的 Windows 系统托盘启动器。无需安装步骤：
下载（或克隆）仓库，编辑一小段配置，然后运行脚本。
托盘图标控制正在运行的服务器——启动 / 停止 / 重启 / 打开
Web UI / 跟踪日志。

快速开始

1. 下载或克隆此仓库。
2. （可选）将 assets/dsh-tray.config.example.ps1 复制为
assets/dsh-tray.config.ps1 并编辑它。配置文件已被 git 忽略，
因此你的主机/密钥路径保留在本地；如果跳过此步骤，将应用内置默认值。
- $port — 服务器端口（默认 3080）。
- $startCommand — 启动 dsh web 的命令（必须位于 PATH 中）。
- $autoStart — 如果服务器尚未运行，则在启动时启动它。
- $pollIntervalMs — 托盘重新检查端口的频率（默认 3000）。
3. 运行它：
powershell -File assets\dsh-tray.ps1

或双击仓库根目录下的 dsh-tray.vbs——它通过 wscript.exe 启动脚本，
因此完全不会出现控制台窗口。DSH Web
服务器以无头模式启动，托盘图标随即出现。右键单击它以控制
服务器。（dsh-tray.bat 作为后备保留，并且也会经由
VBS 文件运行。）

配置：所有值都位于 assets/dsh-tray.config.ps1 中（从
示例复制）。对于你省略的任何值，将使用 assets/dsh-tray.ps1 中的默认值：
- $workDir — 你的 DeepSeek Harness 仓库根目录。服务器从此处
启动，以便 apps/cli/src/bin.ts 和 tsx 正确解析。
- $startCommand — 启动服务器的命令（默认通过
node --import tsx/esm apps/cli/src/bin.ts web 启动 harness）。
- $port、$autoStart、$pollIntervalMs。
- $mode — local（默认）在本机运行服务器，或 remote
通过 SSH 在云主机上启动它并将其隧道到 127.0.0.1:$port。
- $sshHost、$sshKey、$remoteStartCommand、$stopRemoteServer — 仅在
remote 模式下使用。

要求：Windows，并且 node 位于 PATH 中。

菜单

- Open Web UI — 在默认浏览器中打开 http://127.0.0.1:3080。
- Show Logs (Windows Terminal) — 在 Windows Terminal 标签页中跟踪服务器日志。
- Start / Stop / Restart Server — 与运行状态互斥。
- Launch at login — 复选框；注册/移除每用户 Run 键条目。
- Exit (stop server) — 停止服务器并移除托盘图标。

服务器运行时托盘图标为绿色，停止时为红色。

工作原理

该脚本创建一个 System.Windows.Forms 通知图标，并通过计时器轮询服务器
端口，以保持图标颜色、工具提示和菜单状态准确。如果
服务器意外退出，你会收到气泡警告；如果它自行开始运行
（例如从另一个终端启动），托盘也会检测到。
停止/重启仅针对此托盘启动的进程树——如果某个其他
程序占用端口，托盘在触碰它之前会先询问。“Show Logs”会打开一个
Windows Terminal 标签页，用于跟踪服务器日志。

远程模式（通过 SSH 连接云端主机）

设置 $mode = 'remote'，并填写 $sshHost、$sshKey、$remoteStartCommand。
启动器会在远程 PATH 前面加上 /usr/local/bin:/usr/bin:/bin，这样即使是在
PATH 为空的非登录 SSH 会话中，也能找到 dsh（通常位于 /usr/local/bin/dsh）。
如果你的 dsh 位于其他位置，请将 $remoteStartCommand 设置为其绝对路径。
服务器日志写在云端主机上，并由“Show Logs”显示（它通过 SSH 跟踪
/tmp/dsh-tray.out.log）。
“Start”会通过 SSH 在云端主机上启动服务器，然后打开一个单独的
持久本地隧道（ssh -f -N -L $port:127.0.0.1:$port ），因此 Web
UI 可以像本地模式一样通过 http://127.0.0.1:$port 访问。该隧道
只是一条管道：托盘只会在云端服务器真正开始提供 HTTP 服务后
才报告“ready”（绿色图标）并自动在默认浏览器中打开 Web UI——而不是
仅仅在隧道建立时——因此浏览器永远不会在服务器仍在预热时打开并空转。
在本地模式下，dsh web 会自行打开浏览器，所以托盘在那里不会自动打开。
托盘的状​​态图标和 Open Web UI 之所以能持续工作，是因为
隧道终止于本地端口。“Show Logs”会实时跟踪云端日志
（通过 SSH 执行 tail -f /tmp/dsh-tray.out.log）。“Stop”会终止隧道，并且当
$stopRemoteServer 为 $true 时，还会通过 ssh 登录并 pkill 服务器。
Windows 10+ 自带 OpenSSH（ssh.exe）——无需额外安装。

作为 dsh 插件安装

该仓库声明了 dsh.bundle 清单，因此它也可以直接
安装到 dsh 配置文件中（Windows）：

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

这会将托盘启动器注册为配置文件 bundle；托盘脚本本身
仍然从开始菜单快捷方式、.vbs 文件或手动启动。

插件就绪

该仓库包含 Cordis 插件脚手架——带有
dsh.bundle 清单的 package.json、cordis.patch.yml 和 src/plugin.js。CI 会在每次推送时验证
清单和 PowerShell 语法。

限制

- 仅限 Windows。
- 假定使用默认端口 3080 和默认 web 配置文件。
- “Launch at login”会存储绝对路径；移动仓库后请重新切换它。
- 独立工具，并非 DeepSeek 官方产品。

DSH Tray（中文）

DeepSeek Harness Web 的 Windows 系统托盘启动器。无需安装：下载（或克隆）本仓库，
改一小段配置，直接运行脚本即可。托盘图标用于控制正在运行的服务：启动 / 停止 /
重启 / 打开 Web UI / 查看日志。

快速开始

1. 下载或克隆本仓库。
2. （可选）将 assets/dsh-tray.config.example.ps1 复制为
assets/dsh-tray.config.ps1 并编辑。该配置文件已被 git 忽略，
你的 host/key 路径不会进版本库；若跳过，则使用脚本内置默认值。
- $port — 服务端口（默认 3080）。
- $startCommand — 启动 dsh web 的命令（需在 PATH 中）。
- $autoStart — 若服务未运行，启动时自动拉起。
- $pollIntervalMs — 托盘轮询服务端口的间隔（默认 3000）。
3. 运行：
powershell -File assets\dsh-tray.ps1

或直接双击仓库根目录的 dsh-tray.vbs（通过 wscript.exe 拉起脚本，完全不会
出现任何命令行窗口)。DSH Web 服务以无窗口方式启动，托盘图标随即出现。
右键图标即可控制服务。（dsh-tray.bat 保留作后备，同样会路由到 VBS 文件。）

配置：所有配置项都在 assets/dsh-tray.config.ps1（从示例文件复制而来）。
未在文件中写出的项会使用 assets/dsh-tray.ps1 中的默认值：
- $workDir — 你的 DeepSeek Harness 仓库根目录。服务从这里启动，
这样 apps/cli/src/bin.ts 与 tsx 才能正确解析。
- $startCommand — 启动服务的命令（默认用
node --import tsx/esm apps/cli/src/bin.ts web 拉起 harness）。
- $port、$autoStart、$pollIntervalMs。
- $mode — local（默认）在本机启动服务；设为 remote 则通过 SSH 在云端主机
启动服务并把端口隧道到 127.0.0.1:$port。
- $sshHost、$sshKey、$remoteStartCommand、$stopRemoteServer — 仅 remote 模式使用。

环境要求：Windows，且 node 在 PATH 中。

菜单

- 打开 Web UI — 在默认浏览器中打开 http://127.0.0.1:3080。
- 查看日志 (Windows Terminal) — 在 Windows Terminal 标签页中实时追踪服务日志。
- 启动 / 停止 / 重启服务 — 与运行状态互斥。
- 开机自启 (Launch at login) — 复选项；读写当前用户的 Run 注册表项，无需管理员权限。
- 退出（停止服务） — 停止服务并移除托盘图标。

服务运行时托盘图标为绿色，停止时为红色。

工作原理

脚本创建 System.Windows.Forms 通知图标，并通过定时器轮询服务端口，实时刷新
图标颜色、悬浮提示与菜单状态。服务意外退出时会弹出气泡警告；若服务在托盘之外
被自行拉起（例如从别的终端启动），托盘也能感知到。停止/重启只作用于本托盘启动
的进程树——若端口被其他程序占用，托盘会先询问再处理。“查看日志”会打开一个
Windows Terminal 标签页实时追踪服务日志。

远程模式（云端主机 + SSH）

将 $mode 设为 remote 并填好 $sshHost、$sshKey、$remoteStartCommand。
启动器会在远程 PATH 前补上 /usr/local/bin:/usr/bin:/bin，这样即便非登录的
SSH 会话 PATH 为空也能找到 dsh（通常在 /usr/local/bin/dsh）。若你的 dsh
在其他位置，请把 $remoteStartCommand 写成绝对路径。服务日志写在云端主机上，
由「查看日志」通过 SSH 拉取 /tmp/dsh-tray.out.log 显示。
点「启动」会先在云端主机用 SSH 拉起服务，再单独开一条常驻本地隧道
（ssh -f -N -L $port:127.0.0.1:$port ），于是 Web UI 通过
http://127.0.0.1:$port 访问，与本地模式完全一致。隧道只是个管道：托盘只在云端
服务真正在提供 HTTP 服务时才判定「就绪」（图标变绿）并自动在本地默认浏览器打开
Web UI——而不是隧道一建好就开，避免浏览器连上还在预热的服务一直转圈。本地模式由
dsh web 自己打开浏览器，故托盘不在本地自动打开。托盘的状态图标、「打开 Web UI」
全部照常生效（隧道终结在本地端口）。「查看日志」会实时跟踪云端日志
（tail -f /tmp/dsh-tray.out.log）。点「停止」会杀掉隧道，
若 $stopRemoteServer 为 $true，还会 ssh 进去 pkill 掉云端服务。Windows 10+
自带 OpenSSH（ssh.exe），无需额外安装。

插件化（未来）

本仓库同时保留了 Cordis 插件骨架 —— 含 dsh.bundle manifest 的 package.json、
cordis.patch.yml 与 src/plugin.js —— 以便将来可作为 dsh 插件安装。但那不是
当前用法：现在你只需直接运行脚本。

限制

- 仅支持 Windows。
- 使用默认端口 3080 与默认 web profile。
- “开机自启”记录的是绝对路径；移动仓库位置后需重新勾选一次。
- 独立工具，非 DeepSeek 官方产品。