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 插件管理器（图形界面，推荐新手）
- 打开 DSH 桌面版 → 设置 → 插件（或「插件市场」）。
- 点 添加插件。
- 在输入框里粘贴这一行（注意开头必须带
github:）：
github:wdx0614/dsh-restart-plugin
- 点 安装，等它跑完。这一步需要本机能连上 GitHub
（在命令行里git ls-remote https://github.com/wdx0614/dsh-restart-plugin能成功即可）。 - 下载本仓库（或
git clone），在仓库目录里运行一次：
powershell -ExecutionPolicy Bypass -File .\enable.ps1
- 重启 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()——那需要改壳。
所以本插件用「看门狗 + 优雅关闭」：
- 用户选「重启 DSH」并确认；
- 关闭前先拉起一个脱离的看门狗子进程，它等待 Host 真正退出；
- Host 走 cordis 正规的关闭通道退出（等于正常退出 DSH）；
- 看门狗随后用原可执行文件重新启动
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。
