托盘管家 KAIbsb/dsh-tray

dsh-tray

DeepSeek Harness 的 Windows 系统托盘管理工具：提供启动、重启、停止与崩溃自动恢复，全部在托盘菜单完成。无需终端窗口，适合与浏览器 APP 模式窗口搭配使用。

免责声明：本项目为个人开发的小型工具，未经系统性测试与代码审查，可能存在未知缺陷。请自行评估风险后使用；如遇问题请至 Issues 反馈。

项目已停止维护（2026 年 10 月归档）：DeepSeek Harness 已发布官方桌面端，本项目发布最终版本 v1.6.0 后归档，适配范围限于 dsh 0.1.x 全线。仍在使用 dsh 0.1.x 的用户可继续使用；dsh 0.2 及以上用户与新用户请移步官方桌面端（0.2 的兼容情况见开发者文档）。源码以 MIT 协议保留。

功能特性

- 生命周期管理：启动 / 重启 / 停止 / 退出，全部在托盘右键菜单完成；重启优先采用软重启（从运行中的宿主精确回放启动命令，由独立助手进程等待端口释放后再启动），失败自动回退硬重启
- 单击托盘图标：未运行时自动启动并打开窗口；运行中聚焦已打开的 DSH 窗口（APP 模式或网页标签），不存在时才打开新窗口
- 状态图标：运行中 = 蓝色；停止 = 黑 / 白鲸，随系统深浅色实时切换
- 崩溃自动重启（可开关）：harness 意外退出后自动重新启动，带冷却防死循环
- 开机自启（可开关）：写注册表 HKCU\...\Run，免管理员
- 原生系统右键菜单：Win11 圆角主题样式，深色模式自动跟随
- 无终端窗口：后台启动 node dsh web，输出重定向到独立日志文件 harness.log，与托盘生命周期解耦
- 重启零打扰：重启后已打开的页面通过 dsh 自带的断线重连自动恢复，托盘不强制刷新（无重载、无主题闪烁）；插件前端更新后按一次 Ctrl+R 即可加载新内容
- 窗口 16:9 自适应：托盘打开的 APP 模式窗口按主屏工作区 90% 高的 16:9 比例居中打开，不再是浏览器的随机默认尺寸
- 自动认证：打开窗口时从 harness 日志解析启动地址并自动完成认证（dsh ≥ 0.1.2 的启动地址含 token）；登录 cookie 每次打开时静默续期
- 版本自适应：按已安装 dsh 的版本自动决定启动参数。适配 dsh 0.1.x 全线（逐版本审计记录见开发者文档）；更早版本不再承诺；dsh 0.2 及以上不适配，请移步官方桌面端
- 按需提权：harness 若以管理员身份运行，托盘自动以管理员身份执行 kill（UAC 为「从不通知」时静默）
- 手动主题：跟随系统 / 亮 / 暗（设置窗切换，存 ini theme 键）
- 自动更新：发现新版时设置窗一键下载 + 校验（sha256）+ 部署提示
- 日志：%LOCALAPPDATA%\dsh-tray\tray.log，超过 5MB 自动轮转

下载与安装

- 从 Releases 下载最新的 dsh-tray.exe
- 单文件，零依赖：无需安装任何运行时（Windows 10/11 自带 .NET Framework 4.8），下载后即可直接运行
- 首次运行提示：未签名的可执行文件会被 SmartScreen 提示「未知发布者」→ 点「更多信息」→「仍要运行」（详见 FAQ）
- 升级：下载新 exe 直接覆盖旧文件即可，设置（开机自启、崩溃自动重启、dshtray.ini）不受影响；设置窗检测到新版时也可一键自动更新（下载 + 校验 + 部署提示）
- 想自己编译或贡献代码？见 开发者文档

快速开始

1. 安装依赖

| 依赖 | 说明 |
| Windows 10/11 | .NET Framework 4.8 系统自带 |
| Node.js | 运行 harness 所需 |
| DeepSeek Harness | 安装方法见 DeepSeek-Harness 仓库 |
| 浏览器（Chrome / Edge 等 Chromium 系） | 可选，用于浏览器 APP 模式窗口显示 |

2. 打开方式：APP 模式窗口（默认）或普通网页

harness 的 Web UI 在 http://127.0.0.1:3080。托盘「打开窗口」默认用 Chromium 系浏览器的 APP 模式开一个独立窗口（16:9 自适应主屏，不混进标签页）；偏好普通标签页的话，在 dshtray.ini 设 openmode=browser。关闭窗口不影响 harness，可随时从托盘重新打开。

3. 运行 dsh-tray

运行 dsh-tray.exe → 托盘出现鲸鱼图标 → harness 自动启动（无终端窗口）。启动、重启、停止等操作均在托盘菜单中完成，详见「使用说明」。

使用说明

托盘菜单

右键托盘图标弹出：

打开窗口 ──────── 启动 ← harness 停止时可用重启 ← harness 运行时可用停止 ← 只停 harness，托盘不退 ──────── 设置…
────────
退出 ← 仅退出托盘，harness 保持运行（停止用「停止」）

交互约定

| 操作 | 行为 |
| 左键单击托盘图标 | 未运行：启动；已有 DSH 窗口：聚焦；没有：开新窗口 |
| 右键托盘图标 | 仅弹出菜单 |

状态图标

| 状态 | 图标 |
| 运行中 | 蓝色鲸鱼 |
| 已停止 | 黑 / 白鲸，随系统深浅色切换 |

配置

dshtray.ini 是托盘的唯一配置文件。首次运行会自动在 exe 同目录生成（带注释模板），设置窗口（菜单「设置…」）的所有开关 / 选项也直接改这个文件。修改保存后，下次启动托盘生效。

dshtray.ini
url = http://127.0.0.1:3080 # 默认值;端口由 url 推导,改端口直接改这里
lang = # 界面语言 zh/en,留空 = 跟随系统
autorestart = true # 崩溃自动重启 true/false
autostart = false # 开机自启 true/false(同时写入 Windows 启动项)
theme = # 亮/暗主题:light/dark,留空 = 跟随系统
node = # Node.js 路径,留空 = 自动检测
dshentry = # dsh 入口脚本路径,留空 = 自动检测
dshworkdir = # dsh 工作目录,留空 = 自动推断
chrome = # Chromium 系浏览器路径,留空 = 自动查找 Chrome/Edge
openmode = # 打开方式:app(APP 独立窗口,默认)/ browser(默认浏览器标签页)

留空某行 = 该项使用默认值 / 自动检测（Node / Dsh 入口 / 浏览器走 PATH、常见安装路径、npm 全局目录）；删除或注释某行同样生效。url 是唯一的端口配置项（端口由其自动推导）。autostart 是开机自启的唯一来源，Windows 启动项只是它的镜像（启动时按文件同步）。theme 手动主题（light/dark）优先于系统设置，留空 = 跟随系统。

日志

- %LOCALAPPDATA%\dsh-tray\tray.log —— 托盘自身操作记录（启动 / 停止 / 重启 / 提权 / 自动重启等），超 5MB 自动轮转为 tray.log.old
- %LOCALAPPDATA%\dsh-tray\harness.log —— harness 输出，独立于托盘生命周期（托盘退出后仍在写入）
- 托盘菜单已无「打开日志」；可在设置窗口（菜单「设置…」）里打开日志文件夹

FAQ

完整 FAQ 见 docs/FAQ.md（Full FAQ: docs/FAQ.en.md）。以下为常见问题：

dsh-tray 会访问网络吗？

启动时会后台静默检查一次 GitHub 最新版本（仅此一次；可离线，失败静默，不弹窗）；其余时候不访问网络。除此之外只在本机工作：启动 / 停止本地进程、读写注册表与日志，以及「打开窗口」时唤起本机浏览器。

退出托盘后 harness 还在运行？

这是设计行为：「退出」只退出托盘，harness 保持运行；需要完全停止请用菜单里的「停止」。

为什么有时会弹出 UAC 提权？

当 harness 以管理员身份启动时，停止 / 重启 / 退出需要管理员权限才能结束它，此时会弹 UAC。若系统 UAC 设置为「从不通知」则静默完成，不弹窗。

许可证

MIT License —— 可自由使用、修改、商用、再分发，仅需保留版权声明。