电源托盘启动器 mostkia/dsh-launcher

@mostkia/dsh-launcher

DeepSeek Harness（DSH）的电源控制：侧边栏一个电源按钮，外加一个 Windows 托盘启动器（可拉起、可重启、可查看控制台输出）。

🌏 English · 简体中文

这套东西包含什么

这是一套完整的开关启动插件，为原版dsh新增开关机重启按钮（以后关闭服务器不哟命令行按Ctal+C了）、系统启动器（直接提供快捷方式启动、开机自启动功能）、托盘管理（不用再保着难看的命令行黑框了）

| 部件 | 位置 | 作用 |
| 电源按钮 | DSH 官方侧边栏下方槽位 | 点击弹对话框：关机 / 重启，底部还有 开机自启动 滑动开关 |
| 托盘启动器 | 桌面快捷方式、系统托盘中 | 用于启动DSH及控制查看DSH运行状态 |

截图

| 电源弹窗（浅色） | 电源弹窗（深色） | 侧边栏按钮 |
| 浅色主题下的电源弹窗 | 深色主题下的电源弹窗 | 侧边栏里紧邻“设置”的电源按钮 |

弹窗的颜色、圆角、阴影全部来自主题 token，所以跟随宿主明暗主题；电源按钮用的是宿主侧边栏脚部自己的槽位，紧邻「设置」，不额外占一行。

安装

从 GitHub 装；建议钉住发布 tag
dsh plugin --profile web add github:mostkia/dsh-launcher#v0.2.0

然后重启一次 DSH（dsh web 或你现有的启动方式），再刷新页面。

装到这里就结束了。 插件自己带着 Windows 托盘，会在这次启动时自动装好：拷到 %LOCALAPPDATA%\DSH-Launcher、建桌面 DSH Launcher 快捷方式、并附带卸载脚本。
包管理器不会替我们跑安装脚本（pnpm 10 以上默认拦截依赖的生命周期脚本，而 dsh 的插件命令也没有钩子），所以由插件自己安装自己的搭档；全程不需要管理员权限——托盘完全活在你的用户目录里。
它不会主动打开开机自启，要你自己在托盘菜单或弹窗里开。

想让「重启」按钮真正生效，请用桌面 DSH Launcher 快捷方式启动 DSH（这样才是被托管状态）。

不想要托盘了？按下面的步骤卸掉即可，之后插件就不会再装它。想手动装也行：包里的 tray\install.cmd 依旧可用；设 DSH_LAUNCHER_NO_TRAY_INSTALL=1 可彻底关闭自动安装。

卸载：

1. 插件：dsh plugin --profile web remove @mostkia/dsh-launcher。DSH 还在运行时，插件会察觉自己的包已被删除，并在约半分钟内把托盘一起卸掉；重启一次 DSH 则收尾更干净。
2. 也可以先手动卸托盘：右键托盘图标 →「卸载托盘…」（或运行 %LOCALAPPDATA%\DSH-Launcher\uninstall.cmd，或用包里的 tray\uninstall.cmd）。它会停掉正在运行的托盘、清掉开机自启项与桌面快捷方式、删除安装目录，但不会停 DSH —— DSH 只是不再被托管，你想什么时候关就什么时候关。
加 -DryRun 可先看它会删什么（不改动任何东西），加 -KeepState 则保留 state\ 里的日志。

环境要求

- DSH宿主版本： 0.1.7 或更新（用到 sidebar.footer.action、ctx.appExit 与 webServer 注册接口）。
- Node ^22.19.0 || >=24.0.0（DSH 自身的要求）。
- 托盘与开机自启仅 Windows；插件本体跨平台，遇到不支持时会明确告知。

使用

- 侧边栏电源按钮：关机 = 优雅退出（退出码 0）；重启 = 以重启码退出，由托盘重新拉起。
- 开机自启动：电源弹窗底部的滑动开关，与托盘右键菜单里那个可勾选项，读写的是同一个注册表值（HKCU\Software\Microsoft\Windows\CurrentVersion\Run → DSHLauncher）。
- 托盘图标：双击查看抓取到的控制台输出；右键菜单含 显示/隐藏、启动、重启、打开 DSH 界面、打开日志文件、开机自启动、关闭 DSH 并退出。

HTTP 接口（给脚本/其它启动器用）

所有端点会拒绝任何不是本机回环地址的 Origin（一律 403），且都在本插件自己的命名空间下。
不带 Origin 的请求（脚本、curl）按设计放行：浏览器在 POST 时一定会带 Origin，所以"没有这个头"才是 CSRF 守卫该忽略的情形；而带着 Origin 时绝不能因为它的 host 与请求的 Host 相同就信任——早期版本正是这么写的，那是一个 DNS 重绑定漏洞（评审实测发现）。

| 方法 | 路径 | 含义 |
| GET | /_dsh-launcher/status | 平台、pid、是否有监督器、自启状态 |
| POST | /_dsh-launcher/shutdown | 优雅退出，退出码 0 |
| POST | /_dsh-launcher/restart | 优雅退出，退出码 42（仅在有监督器时） |
| POST | /_dsh-launcher/autostart/enable | 注册开机自启 |
| POST | /_dsh-launcher/autostart/disable | 取消开机自启 |

测试

两半都带自测，不需要真实 dsh 会话：

宿主半部：端点、守卫、退出码、自启状态（23 项）
node test/host-half.test.mjs

客户端半部：槽位注册与中英文案完整性（无需浏览器）
node test/client-half.test.mjs

托盘：监督探测与两条重启路径（对着假 dsh 跑） powershell -NoProfile -ExecutionPolicy Bypass -File test\tray-supervision.ps1

托盘测试在临时端口用 test/fake-dsh.mjs（一个会说插件端点的小 HTTP 服务）当被监督的子进程，不会启动、杀掉或重启你的真实 dsh。它钉住的是最要紧的那个判断：子进程确实被监督时，托盘才去请求插件并等重启码；发现没被监督时不去调那个必然回 ok:false 的端点，自己强制重启。受限 shell 里 taskkill 会被拒绝，所以强制路径的"杀进程"那一步在那里观察不到，脚本会说明该限制（假子进程改为自行退出）。

维护者：发布前的自检、打标签与上架步骤见 RELEASE.md。以上测试外加"发布产物内容检查"，每次 push / PR 都由 CI 跑一遍（.github/workflows/tests.yml）。

设计说明

- 刻意零运行时依赖：所有 @deepseek-ai/ 都写在 peerDependencies，绝不写进 dependencies——包管理器一旦在 profile 里装出第二份物理副本，包内私有 Symbol 就会分裂，宿主调度器会直接报错。
- 客户端半部不 import 任何东西：不依赖 @deepseek-ai/dsh-client-ui-，界面全部用主题 token（--dsw-alias-、--dsw-radius-、--dsw-shadow-*）手写，明暗主题与宿主设计语言自动跟随；所有可见文字走客户端 locale 服务（中 + 英）。
- 不与其它插件冲突：只占用自己的路径，不在路由层做"共存/替换 dsh-shutdown"的兼容——各自单装都能用。

致谢与许可

部分功能的实现思路参考了 dsh-shutdown（MIT），但未包含其任何代码。
托盘图标取自 DSH 前端自带的 favicon.svg，用于标识本启动器。

MIT © 2026 mostkia