左键单击图标 → 打开 dsh 界面（服务未运行则先自动启动；浏览器已开则不新开标签，只切换/还原窗口）
右键菜单：
- 打开界面
- 启动服务 / 停止服务（按运行状态自动置灰）
- 管家开机自启（勾选 ✓ 显示在文字后，登录时静默启动托盘）
- 服务开机自启（登录后延迟 60 秒静默启动 dsh web 服务，避开登录高峰）
- 打开日志文件夹（资源管理器定位到 dsh-web.log）
- 退出管家（服务不受影响，进程干净退出）
菜单样式：浅色圆角（18px）+ 投影阴影，贴近主流桌面应用
菜单自动收起：点击菜单外任意位置即收起（无全局钩子，不影响系统输入性能）
服务状态变化时气泡通知（已启动 / 已停止），并记录系统快照到日志
单实例保护：被强杀留下的"遗弃锁"会自动接管，重复启动静默退出
无周期定时器：状态按需刷新（菜单打开时/操作后），UI 线程零定时开销，菜单悬停流畅

工作原理

托盘程序用 PowerShell (WinForms) 实现，常驻系统托盘（约几十 MB 内存）
通过检测 3080 端口判断 dsh web 是否在运行
启动：隐藏窗口运行 %APPDATA%\npm\dsh.cmd web，服务输出（后台日志）重定向写入 dsh-web.log
停止：按端口找到进程 PID 并结束
开机自启：启动文件夹方案（普通用户可写可删，无需管理员，绕开计划任务的权限限制）——dsh-tray.vbs（管家，登录立即起）、dsh-web-service.vbs（服务，脚本内延迟 60 秒再起）

日志与排障

日志文件：C:\Users\11039\AppData\Local\dsh-tray\dsh-web.log
内容：dsh web 后台输出 + [管家] 操作记录 + 系统快照（服务停止/启动瞬间的 CPU 前 5 与内存占用，用于排查卡顿）
注意：只有由托盘启动的服务输出才会写入日志；手动在终端启动的服务不写入

快速开始（本机）

# 1. 把 dsh-tray 文件夹复制到任意位置，然后：
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
# 2. 右下角托盘出现「dsh web 管家」图标即成功（install 会自动创建开机自启任务并启动托盘）

卸载：

powershell -NoProfile -ExecutionPolicy Bypass -File .\uninstall.ps1

手动启动（桌面备用快捷方式「dsh web 管家」亦可）：双击 start-tray.vbs（隐藏窗口，零闪烁）。

发布到 npm（社区分享）

# 在 dsh-tray 目录下
npm login
npm publish

之后别人可以：

npm i -g dsh-tray
dsh-tray

说明：dsh-tray 是桌面工具而非 DSH 的 cordis 插件——插件运行在浏览器/服务器进程内，无法管理系统托盘；托盘必须独立于服务进程才能实现"停止/重启服务"。发布后可收录到 awesome-deepseek-harness 或 awesome-dsh-plugin 列表。

环境要求

Windows 10/11
PowerShell 5.1+（系统自带）
已安装 DeepSeek Harness（dsh，%APPDATA%\npm\dsh.cmd 存在）

文件说明

文件	说明
`dsh-tray.ps1`	托盘管家主程序（UTF-8 BOM，中文界面）
`dsh-web-service.ps1`	服务自启启动器（登录后延迟 60 秒静默启动服务）
`install.ps1` / `uninstall.ps1`	安装 / 卸载（复制到 `%LOCALAPPDATA%\dsh-tray`、创建自启任务、启动托盘）
`start-tray.vbs`	隐藏窗口启动托盘（零闪烁）
`dsh-web.ico`	托盘图标（鲸鱼 D 造型，取材自官网配色）
`dsh-web.log`	服务与管家日志（运行后生成）
`bin/dsh-tray.js`	npm 全局命令入口