dsh-kill-restart ☠
DSH Web GUI 的一键杀死按钮。 无需 taskkill 或翻找 PID,一键终止 DSH 服务器进程,方便重启。
工作原理
1. 一个 ☠ 骷髅按钮出现在 DSH Web GUI 右下角。 2. 点击 → 确认弹窗。 3. 浏览器发送 POST /api/kill-dsh。 4. 服务器先响应 { "ok": true },等 200 毫秒让浏览器收到确认,然后调用 process.exit(0)。 5. 页面显示"DSH 服务器进程已终止 — 请重启 DSH"。
安装
从 npm 安装(推荐)
dsh plugin --profile web add dsh-kill-restart从 GitHub 安装
dsh plugin --profile web add github:mozhi5795/dsh-kill-restart> 注意:Git 安装拉取的是源码而非构建产物。你必须: > - 使用包含预构建 lib/ 文件的 tag,或 > - 在 profile 的 pnpm-workspace.yaml 中允许 prepare 脚本: > ``yaml > allowBuilds: > dsh-kill-restart: true > ``
从本地目录安装
# 在包含 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 插件开发文档, 生效配置在空根之上按以下顺序逐层组合:
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:
npm login
npm publish发布后,用户通过以下命令安装:
dsh plugin --profile web add dsh-kill-restart开发
这是一个纯 JavaScript(ESM)插件 — 无需构建步骤。 直接在 lib/ 中编辑文件,然后用 --patch 覆盖层或 dsh plugin add ./dsh-kill-restart 本地测试。
许可证
MIT