deepseek-tray

deepseek-tray

DeepSeek Harness Web 版桌面包装（Windows 系统托盘 + 守护进程）。

把 dsh web 变成常驻托盘应用：全程隐藏终端、异常自动重启、一键开机自启、一键更新。

开机自启为静默启动：不弹终端、不打开浏览器。需要时从托盘菜单"打开 Web 界面"（自动带 token，直接进入已认证界面）。

特性

• 隐藏终端：以 node <dsh>/lib/bin.js web --no-open 直接启动（无 shell 包装），子进程使用 CREATE_NO_WINDOW + HideWindow
• 守护重启：异常退出自动重启，指数退避（基准可配，封顶 2 分钟；稳定运行 30s 后复位），杜绝重启风暴
• 端口预检：端口已被占用（例如已有实例）时不启动，改为温和等待（封顶 30s 轮询），避免端口冲突
• 启停管理：托盘一键启动 / 停止 / 重启；停止为同步等待（最多 8s），重启前等待端口释放
• 开机自启：托盘勾选或 autostart on|off（写 HKCU Run 键，无需管理员权限）
• 一键更新：执行 npm install -g @deepseek-ai/dsh@latest --allow-scripts=...；可开启定期后台更新（常驻单例循环：关闭仅暂停计时，再次开启立即恢复）
• 带 token 打开：捕获 dsh web 输出的访问地址；菜单标题只显示 origin，token 只存内存
• 安全：日志自动脱敏 token=***；打开 URL/路径不经 shell 解析（rundll32 / explorer）
• 健壮：配置原子写入（临时文件 + rename）、支持 UTF-8 BOM、损坏配置回退默认值；日志按天轮转；进程树终止失败时退化为直接终止
• 单实例：Local 命名互斥体（普通用户可创建，避免 Global 权限失败导致失效）
• 可验证：8 个单元测试覆盖脱敏、URL 提取、配置归一、端口探测、退避、日志轮转
• 低依赖：第三方仅 2 个（getlantern/systray、golang.org/x/sys），单文件分发约 5 MB

构建与测试

go vet ./...        # 静态检查
go test ./...       # 单元测试
go build -ldflags "-H=windowsgui -s -w" -o deepseek-tray.exe .

运行方式

命令	说明
deepseek-tray.exe	托盘模式（默认）
deepseek-tray.exe --silent	静默托盘（开机自启使用，无窗口、不打开浏览器）
deepseek-tray.exe daemon	无 UI 守护模式（支持优雅退出信号，适合注册为 Windows 服务）
deepseek-tray.exe status	状态查询（同时写日志）
deepseek-tray.exe autostart [on\|off]	查看/设置开机自启
deepseek-tray.exe version	版本号

CLI 子命令在真实终端中输出（通过 AttachConsole）；无终端场景可从日志回溯。

注册为 Windows 服务（可选）

nssm install DeepSeekTray "C:\path\to\deepseek-tray.exe" daemon
nssm start DeepSeekTray

托盘菜单

• 状态：运行中 (PID) / 已停止 / 外部实例运行中 / 正在更新（提示含运行时长与重启次数）
• 打开 Web 界面（带 token，直接进入）
• 启动 / 停止 / 重启服务
• 开机自启（勾选）
• 定期自动更新（勾选）、立即更新 DSH
• 版本：当前安装的 dsh 版本
• 查看日志 / 打开配置文件
• 退出（停止服务并退出）

配置

位置：%APPDATA%\deepseek-tray\config.json（首次运行自动生成，原子写入）

{
  "webPort": 3080,
  "webHost": "127.0.0.1",
  "nodePath": "",
  "dshBinJs": "",
  "autoStart": false,
  "autoUpdate": false,
  "updateIntervalHours": 24,
  "restartDelaySeconds": 5
}

字段	说明
webPort / webHost	dsh web 监听端口与地址（默认 3080 / 127.0.0.1）
nodePath / dshBinJs	留空自动探测（node + npm root -g 下的 dsh 入口）
autoStart	开机自启（与托盘勾选同步）
autoUpdate / updateIntervalHours	定期后台更新开关与间隔
restartDelaySeconds	重启退避的基准延迟（按失败次数指数放大，封顶 2 分钟）

修改配置文件后需重启程序生效。

源码结构

文件	职责
main.go	入口与 CLI 子命令（托盘 / daemon / status / autostart）
supervisor.go	守护核心：端口预检、隐藏启动、退避重启、状态快照
probe.go	环境探测：node 路径、dsh 入口、已装版本（带缓存与串行化）
updater.go	更新与定期更新循环
tray.go	托盘菜单与交互
config.go / logger.go / npm.go / util.go	配置、日志、npm 调用、纯工具
*_windows.go	Win32 细节（隐藏窗口、进程树终止、单实例、控制台附加）
util_test.go	单元测试

日志

%APPDATA%\deepseek-tray\logs\tray-YYYYMMDD.log（按天轮转；含 dsh web 的 stdout/stderr；token 已脱敏）

验证结论

单元测试（go test）

测试	覆盖
TestRedact	token 脱敏（多 token / 终止符 / 无 token / 空串）
TestExtractHTTPURL	URL 提取与误报拒绝（httpx）
TestShortURL / TestHumanDuration	展示格式化
TestConfigNormalized	配置越界回退默认值
TestIsPortOpen	真实监听端口的探测
TestBackoff	退避序列与封顶（此测试发现并修复了上限未生效问题）
TestLoggerRotate	日志按天轮转

运行时验证（v2.2.0 回归）

维度	验证项	结果
可靠性	隐藏终端（daemon / dsh web 窗口句柄）	均为 0
可靠性	自动重启（假命令立即退出）	启动 6 次 / 退出 4 次 / 重启 4 次
可靠性	单实例（启动第二个实例）	立即退出并记录
健壮性	端口被占用	不启动冲突进程，退避 6s→12s→24s
健壮性	配置损坏 / UTF-8 BOM	回退默认值 / 正确读取
安全性	日志 token	输出 token=***
安全性	打开 URL/路径	不经 shell 解析
效率	status 查询 / 二进制	0.4 秒 / 约 5.2 MB

环境要求

• Windows 10/11
• 已全局安装 dsh：npm install -g @deepseek-ai/dsh@latest --allow-scripts='@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs'
• node 在 PATH 中

版本

• v2.2.0 — 二次迭代：新增单元测试（并借其修复退避上限问题）、修复定期更新"关闭后再开启"失效、职责拆分（probe/util）、日志按天轮转、进程终止兜底、daemon 优雅退出
• v2.1.0 — 自检优化：端口预检 + 指数退避 + 定期更新单例 + Local 互斥体 + 日志脱敏 + 原子配置 + autostart 子命令
• v2.0.0 — 重写为 dsh web 托盘守护（旧版余额查询功能归档于 legacy-v1 标签）

许可证

见 LICENSE。