电源菜单 wdx0614/dsh-restart-plugin

DSH 电源菜单（dsh-restart-plugin）

给 DeepSeek Harness（DSH）桌面版 加一个电源按钮：点一下，可以重启 DSH 或关闭 DSH。

安装、启用、禁用、卸载插件后，常常要重启 DSH 才生效；而 DSH 桌面版关掉窗口只是收进托盘，真正退出或重启要去托盘菜单里翻。这个插件把这两个动作搬到侧边栏底部，一步到位。

Windows / macOS 桌面版 · 纯本地 · 无遥测 · MIT

功能

- 电源按钮在侧边栏最底部一行的右侧（头像右边）。点击向上弹出菜单。
- 二级菜单两项，图标 + 文字：
- 重启 DSH（环形箭头）— 关闭应用，几秒后自动重新打开。
- 关闭 DSH（门 + 箭头）— 完全退出应用，不重新打开；下次需手动启动。
- 有任务时会拦一次：如果有正在运行或已排期的任务，会明确提示「任务会被中断」，需要再点一次「仍然重启 / 仍然关闭」才执行。绝不静默中断。
- 非桌面环境明确拒绝：dsh web 之类环境里会说明无法自动重启，而不是假装成功。
- 跟随主题：颜色只用 --dsw-* 主题变量，浅色/深色自动适配。
- 键盘可用：菜单里 ↑/↓ 移动、Enter/空格执行、Esc 关闭、点菜单外也能关。

安装

重要：装完必须再运行一次 enable.ps1，把插件补进 profile 的 dsh.profile.bundles，然后重启 DSH。少了这一步，按钮不会出现——这是 DSH 插件管理器只写 dependencies、不写 bundles 的已知行为，不是插件本身的问题。

方式 A：通过 DSH 插件管理器（图形界面，推荐新手）

1. 打开 DSH 桌面版 → 设置 → 插件（或「插件市场」）。
2. 点 添加插件。
3. 在输入框里粘贴这一行（注意开头必须带 github:）：

github:wdx0614/dsh-restart-plugin

4. 点 安装，等它跑完。这一步需要本机能连上 GitHub （在命令行里 git ls-remote https://github.com/wdx0614/dsh-restart-plugin 能成功即可）。
5. 下载本仓库（或 git clone），在仓库目录里运行一次：

powershell -ExecutionPolicy Bypass -File .\enable.ps1

6. 重启 DSH。之后左侧边栏最底部右侧会出现电源按钮。

方式 B：命令行安装

dsh plugin --profile desktop add github:wdx0614/dsh-restart-plugin
powershell -ExecutionPolicy Bypass -File .\enable.ps1

dsh 是 DSH 自带的命令行工具；如果系统 PATH 里没有，用安装目录下的 <安装目录>\resources\runtime\cli\bin\dsh.cmd。

方式 C：从本机克隆的源码安装（改代码调试时用）

git clone https://github.com/wdx0614/dsh-restart-plugin.git
dsh plugin --profile desktop add file:<克隆下来的目录>
powershell -ExecutionPolicy Bypass -File .\enable.ps1

装完按钮不出来？

按顺序查这三件事：

| 现象 | 原因 | 怎么办 |
| 提示「这个包没有声明组合包」 | 仓库根目录缺 package.json，或 package.json 里没有 dsh.bundle 声明 | 升级到 1.1.0+（包已放到仓库根目录）；旧结构装不了 |
| 提示 not a package name the registry accepts | 输入框里只写了 wdx0614/dsh-restart-plugin，少了 github: 前缀 | 改成 github:wdx0614/dsh-restart-plugin |
| 插件「已启用」但按钮不出现 / 点了 404 | 只进了 dependencies，没进 dsh.profile.bundles | 运行 enable.ps1，然后重启 DSH |
| 运行 enable.ps1 后仍不出现 | Host 半要重启进程才加载 | 完全退出 DSH（托盘右键退出），再重新打开 |

详细步骤见 docs/安装与使用.md。

它是怎么实现「重启」的

Host 是 Electron 的子进程，纯插件没法让 Electron 主进程调用 app.relaunch()——那需要改壳。
所以本插件用「看门狗 + 优雅关闭」：

1. 用户选「重启 DSH」并确认；
2. 关闭前先拉起一个脱离的看门狗子进程，它等待 Host 真正退出；
3. Host 走 cordis 正规的关闭通道退出（等于正常退出 DSH）；
4. 看门狗随后用原可执行文件重新启动 DeepSeek Harness.exe。

「关闭 DSH」走同一套退出流程，只是不拉看门狗——没有人去重新打开应用。

详见 docs/实现原理与风险.md，其中有实测与未验证之分的标注。

验证状态

| 项目 | 状态 |
| 单元测试 27 项 | ✅ 全通过（实测） |
| 看门狗端到端 4/4 | ✅ 全通过（实测） |
| 完整重启链路 8/8 | ✅ 全通过（假进程仿真，实测） |
| 真机重启（3 次） | ✅ 应用确实关闭并自动重开（实测，见 测试记录） |
| 窗口自动置顶 | ✅ 已修复并真机验证（实测） |
| 有任务时二次确认 | ✅ 实测返回 409 要求确认 |
| 非桌面环境拒绝 | ✅ 实测返回 409 not-desktop |
| 电源按钮 + 二级菜单 | ✅ 已实现；界面观感待真机确认（未验证） |
| 托盘残留一个幽灵图标 | ⚠️ 已知缺陷，接受（无 CPU/内存开销，悬停即消失；彻底修需改 Electron 壳） |

目录结构

插件包就在仓库根目录（这样 github: 安装才能识别），不是放在子目录里：

package.json 包清单（dsh.bundle.patch + dsh.client），必须放在根目录 cordis.patch.yml Loader 补丁，用来插入 Host 行 index.js Host 半：重启/关闭控制器 + HTTP 路由 + 看门狗 client.js Client 半：电源按钮 + 二级菜单 + 确认框
locale/{en,zh}.json 插件列表里的显示元数据
icon.svg 插件图标 enable.ps1 装完后补 dsh.profile.bundles 的脚本（必跑一次） tests/ 单元测试 tools/ 验证与诊断脚本 docs/ 使用说明与原理文档

文档

| 文件 | 内容 |
| docs/安装与使用.md | 小白向：怎么装、怎么用、出问题怎么办 |
| docs/实现原理与风险.md | 原理、实测证据、已知缺陷与风险评估 |
| docs/真机重启测试记录.md | 3 次真机测试的完整过程与证据 |

许可

MIT，见 LICENSE。