dsh-tray

简体中文 | English

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. 安装依赖

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 保持运行(停止用「停止」)

交互约定

状态图标

配置

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 —— 可自由使用、修改、商用、再分发,仅需保留版权声明。