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
• 守护重启：异常退出自动重启，采用指数退避（基准 5s，上限 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\ 权限失败导致失效）
• 低依赖：第三方仅 2 个（getlantern/systray、golang.org/x/sys），单文件分发约 5 MB

构建

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	重启退避的基准延迟（实际按失败次数指数放大）

日志

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

验证结论（v2.1.0）

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

环境要求

• 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.1.0 — 自检优化：端口预检 + 指数退避 + 定期更新单例 + Local 互斥体 + 日志脱敏 + 原子配置 + autostart 子命令
• v2.0.0 — 重写为 dsh web 托盘守护（旧版余额查询功能归档于 legacy-v1 标签）

许可证

见 LICENSE。