dsh-kill-restart

Readme

# dsh-kill-restart ☠

[DSH Web GUI](https://deepseek-harness.github.io/deepseek-harness/) 的一键杀死按钮。
无需 `taskkill` 或翻找 PID，一键终止 DSH 服务器进程，方便重启。

## 工作原理

1. 一个 ☠ 骷髅按钮出现在 DSH Web GUI 右下角。
2. 点击 → 确认弹窗。
3. 浏览器发送 `POST /api/kill-dsh`。
4. 服务器先响应 `{ "ok": true }`，等 200 毫秒让浏览器收到确认，然后调用 `process.exit(0)`。
5. 页面显示"DSH 服务器进程已终止 — 请重启 DSH"。

## 安装

### 从 npm 安装（推荐）

```sh
dsh plugin --profile web add dsh-kill-restart
```

### 从 GitHub 安装

```sh
dsh plugin --profile web add github:mozhi5795/dsh-kill-restart
```

> **注意**：Git 安装拉取的是源码而非构建产物。你必须：
> - 使用包含预构建 `lib/` 文件的 tag，或
> - 在 profile 的 `pnpm-workspace.yaml` 中允许 `prepare` 脚本：
>   ```yaml
>   allowBuilds:
>     dsh-kill-restart: true
>   ```

### 从本地目录安装

```sh
# 在包含 dsh-kill-restart 的目录中执行
dsh plugin --profile web add ./dsh-kill-restart
```

## 使用

1. 启动包含此组合包的 DSH profile。
2. 打开 Web GUI（默认 `http://127.0.0.1:3080`）。
3. 点击右下角的 ☠ 按钮。
4. 确认弹窗。
5. 服务器退出，手动重启 DSH。

## 项目结构

```
dsh-kill-restart/
├── package.json          # 组合包清单（dsh.bundle + dsh.client）
├── cordis.patch.yml      # Cordis 补丁层 — 插入插件行
├── README.md             # 本文件
├── .gitignore
└── lib/
    ├── index.js          # 服务端 — POST /api/kill-dsh 路由
    └── client.js         # 客户端 — ☠ 按钮 UI
```

## 架构

这是一个 **DSH 组合包（bundle）** — 一个可安装的 npm 包，附带配置层。

| 概念 | 文件 | 作用 |
|---------|------|------|
| **组合包清单** | `package.json` | 声明 `dsh.bundle.patch`（补丁文件）和 `dsh.client`（客户端模块注入） |
| **补丁层** | `cordis.patch.yml` | 当 profile 列出此组合包时被插入；添加 `kill-dsh-restart` 插件行 |
| **服务端插件** | `lib/index.js` | 注入 `webServer`，注册 `POST /api/kill-dsh`，响应后调用 `process.exit(0)` |
| **客户端插件** | `lib/client.js` | 通过 `exports["./client"]` 注入浏览器；添加浮动 ☠ 按钮及点击处理器 |

### 加载顺序

根据 [DSH 插件开发文档](https://deepseek-harness.github.io/deepseek-harness/develop/basic/publish/)，
生效配置在空根之上按以下顺序逐层组合：

1. profile 的 `bundles` 列表中的各组合包补丁（按列表顺序）
2. profile 自己的 `cordis.patch.yml`
3. home 级 `$DSH_HOME/cordis.patch.yml`
4. 每个 `--patch <路径>` 覆盖层

此组合包的补丁（`cordis.patch.yml`）在 profile 列出 `dsh-kill-restart` 时，于第 1 步被应用。

## 发布到 npm

此包已准备好发布到 npm：

```sh
npm login
npm publish
```

发布后，用户通过以下命令安装：

```sh
dsh plugin --profile web add dsh-kill-restart
```

## 开发

这是一个纯 JavaScript（ESM）插件 — 无需构建步骤。
直接在 `lib/` 中编辑文件，然后用 `--patch` 覆盖层或 `dsh plugin add ./dsh-kill-restart` 本地测试。

## 许可证

MIT