DSH Tray
A Windows system-tray launcher for DeepSeek Harness Web. No install step:
download (or clone) the repo, edit a small config block, and run the script.
The tray icon controls the running server — start / stop / restart / open the
Web UI / tail logs.
Quick start
- Download or clone this repo.
- (Optional) edit the
CONFIG block at the top of assets/dsh-tray.ps1:
$port — server port (default 3080).$startCommand — the command that launches dsh web (must be on PATH).$autoStart — start the server on launch if it is not already running.
- Run it:
powershell -File assets\dsh-tray.ps1
or double-click dsh-tray.vbs at the repo root — it launches the script
through wscript.exe, so no console window appears at all. The DSH Web
server starts headless and the tray icon appears. Right-click it to control
the server. (dsh-tray.bat is kept as a fallback and also routes through the
VBS file.)
Configuration: edit the CONFIG block at the top of assets/dsh-tray.ps1:
$workDir — your DeepSeek Harness repo root. The server is started from
here so apps/cli/src/bin.ts and tsx resolve correctly.$startCommand — the command that starts the server (default launches the
harness via node --import tsx/esm apps/cli/src/bin.ts web).$port, $autoStart.
Requirements: Windows, and node on PATH.
Menu
- Open Web UI — open http://127.0.0.1:3080 in the default browser.
- Show Logs (Windows Terminal) — tail the server log in a Windows Terminal tab.
- Start / Stop / Restart Server — mutually exclusive with the running state.
- Exit (stop server) — stop the server and remove the tray icon.
How it works
The script creates a System.Windows.Forms notify icon, polls the server port
to keep the menu state accurate, and drives dsh web for start/stop/restart.
"Show Logs" opens a Windows Terminal tab that tails the server log. Once the
server is up, the default browser opens to the Web UI automatically.
Install as a dsh plugin
The repo declares a dsh.bundle manifest, so it can also be installed directly
into a dsh profile (Windows):
dsh plugin --profile web add https://github.com/nxz1026/dsh-tray
This registers the tray launcher as a profile bundle; the tray script itself is
still started from the Start-menu shortcut, the .vbs file, or manually.
Plugin-ready
This repo carries Cordis plugin scaffolding — package.json with a
dsh.bundle manifest, cordis.patch.yml, and src/plugin.js. CI validates the
manifest and PowerShell syntax on every push.
Limitations
- Windows only.
- Assumes the default port 3080 and the default web profile.
- "Restart" stops the server on the port; bring it back up yourself.
- Independent tool, not an official DeepSeek product.
DSH Tray（中文）
DeepSeek Harness Web 的 Windows 系统托盘启动器。无需安装:下载(或克隆)本仓库,
改一小段配置,直接运行脚本即可。托盘图标用于控制正在运行的服务:启动 / 停止 /
重启 / 打开 Web UI / 查看日志。
快速开始
- 下载或克隆本仓库。
- (可选)编辑
assets/dsh-tray.ps1 顶部的 CONFIG 配置区:
$port — 服务端口(默认 3080)。$startCommand — 启动 dsh web 的命令(需在 PATH 中)。$autoStart — 若服务未运行,启动时自动拉起。
- 运行:
powershell -File assets\dsh-tray.ps1
或直接双击仓库根目录的 dsh-tray.vbs(通过 wscript.exe 拉起脚本,完全不会
出现任何命令行窗口)。DSH Web 服务以无窗口方式启动,托盘图标随即出现。
右键图标即可控制服务。(dsh-tray.bat 保留作后备,同样会路由到 VBS 文件。)
配置:编辑 assets/dsh-tray.ps1 顶部的 CONFIG 配置区:
$workDir — 你的 DeepSeek Harness 仓库根目录。服务从这里启动,
这样 apps/cli/src/bin.ts 与 tsx 才能正确解析。$startCommand — 启动服务的命令(默认用
node --import tsx/esm apps/cli/src/bin.ts web 拉起 harness)。$port、$autoStart。
环境要求:Windows,且 node 在 PATH 中。
菜单
- 打开 Web UI — 在默认浏览器中打开 http://127.0.0.1:3080。
- 查看日志 (Windows Terminal) — 在 Windows Terminal 标签页中实时追踪服务日志。
- 启动 / 停止 / 重启服务 — 与运行状态互斥。
- 退出(停止服务) — 停止服务并移除托盘图标。
工作原理
脚本创建 System.Windows.Forms 通知图标,轮询服务端口以保持菜单状态准确,
并通过 dsh web 实现启动 / 停止 / 重启。"查看日志"会打开一个 Windows Terminal
标签页实时追踪服务日志。服务就绪后,默认浏览器会自动打开 Web UI。
插件化(未来)
本仓库同时保留了 Cordis 插件骨架 —— 含 dsh.bundle manifest 的 package.json、
cordis.patch.yml 与 src/plugin.js —— 以便将来可作为 dsh 插件安装。但那不是
当前用法:现在你只需直接运行脚本。
限制
- 仅支持 Windows。
- 使用默认端口 3080 与默认 web profile。
- "重启"会停止端口上的服务,需自行重新拉起。
- 独立工具,非 DeepSeek 官方产品。
