dsh-shutdown-button

Readme

# dsh-shutdown-button ⏻

DeepSeek Harness 关机按钮插件 —— 作为固定插件常驻在 dsh Web GUI 左下角（侧栏脚部），一键弹窗确认后**安全结束 DSH 进程**。

## 功能

- **左下角关机按钮**:位于侧栏脚部、设置按钮上方，与设置按钮完全对齐（整行按钮，展开时图标 + 文字，收起为 56px 窄栏时圆形图标）
- **弹窗确认**:点击后弹出「确认关机？」对话框，避免误触
- **安全退出**:确认后走 DSH 启动器提供的 `ctx.appExit` 有界优雅关机——整体释放应用 Fiber（有序收尾持久化、服务、连接），超时兜底，随后以退出码 0 正常结束进程
- **随启动自动装载**:以 `dsh.bundle` 形式装入 profile，无需手动批准或装载

## 目录结构

```
dsh-shutdown-button/
├── package.json              # 仓库根包声明（供 git/file 安装：dsh.bundle.patch + dsh.client + files）
├── plugin/                   # 插件源码（手动复制安装时的包源）
│   ├── index.js              # Host 端：POST /__dsh-shutdown/request 安全退出路由
│   ├── client.js             # 浏览器端：关机按钮 + 确认弹窗 UI（bundle 无需构建）
│   ├── cordis.patch.yml      # bundle 补丁层：插入插件行
│   └── package.json          # plugin/ 形态的包声明
└── README.md
```

## 安装

本插件是 dsh 的 **out-of-tree bundle**。

### 方式一：从 GitHub 直接安装（推荐）

```sh
dsh plugin --profile web add github:Yelloooooow/dsh-shutdown-button
```

`dsh plugin` 会把仓库作为插件包安装到 profile，并因包声明了 `dsh.bundle.patch` 而**自动加入 `dsh.profile.bundles`**。装完重启 Harness，左下角即出现关机按钮。

### 方式二：本地目录安装

```sh
dsh plugin --profile web add file:/path/to/dsh-shutdown-button/plugin
```

## 使用

点击左下角电源图标 → 弹窗确认 → 确认后 DSH 安全退出。撤销请点击「取消」。

## 卸载

```sh
dsh plugin --profile web remove dsh-shutdown-button
```

重启后插件即被移除。

## 许可

[MIT](LICENSE)