deepseek-tray

deepseek-tray

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

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

特性

• 隐藏终端：以 node <dsh>/lib/bin.js web --no-open 直接启动（无 shell 包装），子进程使用 CREATE_NO_WINDOW + HideWindow，无任何命令行窗口
• 守护重启：进程异常退出后自动重启（可配置延迟），托盘显示运行状态、PID、重启次数
• 启停管理：托盘菜单一键启动 / 停止 / 重启，实时状态查询
• 开机自启：一键开关（写 HKCU Run 键，无需管理员权限）
• 一键更新：执行 npm install -g @deepseek-ai/dsh@latest --allow-scripts=...，可开启定期后台更新（发现新版本才更新并重启）
• 带 token 打开：自动捕获 dsh web 输出的访问地址（含 token），点菜单直接进入已认证界面
• 单实例保护：命名互斥体，避免重复守护
• 零外部依赖：除托盘库外无运行时依赖，单文件分发（约 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 version	版本号

注册为 Windows 服务（可选）

使用 NSSM：

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	异常退出后的重启延迟

配置支持 UTF-8 BOM（记事本编辑后仍可解析）。

日志

%APPDATA%\deepseek-tray\logs\tray-YYYYMMDD.log（含 dsh web 的 stdout/stderr）

环境要求

• 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 中

许可证

见 LICENSE。

版本

• v2.0.0 — 重写为 dsh web 托盘守护（旧版余额查询功能已归档于 legacy-v1 标签）