# @mostkia/dsh-launcher

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

🌏 [English](./README.md) · **简体中文**

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

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

## 截图

| 电源弹窗（浅色） | 电源弹窗（深色） | 侧边栏按钮 |
|:--:|:--:|:--:|
| ![浅色主题下的电源弹窗](docs/screenshots/power-dialog-light.png) | ![深色主题下的电源弹窗](docs/screenshots/power-dialog-dark.png) | ![侧边栏里紧邻“设置”的电源按钮](docs/screenshots/sidebar-power.png) |

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

## 安装

```bash
# 从 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. 托盘：**右键托盘图标 →「卸载托盘…」**（或运行 `%LOCALAPPDATA%\DSH-Launcher\uninstall.cmd`，
   或用包里的 `tray\uninstall.cmd`）。它会停掉正在运行的托盘、清掉开机自启项与桌面快捷方式、
   删除安装目录，但**不会**停 DSH —— DSH 只是不再被托管，你想什么时候关就什么时候关。
   加 `-DryRun` 可先看它会删什么（不改动任何东西），加 `-KeepState` 则保留 `state\` 里的日志。
2. 插件：`dsh plugin --profile web remove @mostkia/dsh-launcher`，然后重启一次 DSH。
   **这条命令不会删除托盘。** 插件无法可靠察觉自己被卸载（真机实测：运行中的进程仍持有插件、
   始终没发现 profile 的变化），所以我们宁可如实说明，也不承诺一个不会发生的自动清理 ——
   卸托盘就用第 1 步。反过来，手动卸托盘**会**被记住：插件不会再把托盘装回来。

## 环境要求

- 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 会话：

```bash
# 宿主半部：端点、守卫、退出码、自启状态（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](./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](https://github.com/knlght/DSH-shutdown)（MIT），但**未包含其任何代码**。
托盘图标取自 DSH 前端自带的 `favicon.svg`，用于标识本启动器。

[MIT](./LICENSE) © 2026 mostkia