电源开关 hongdougao111/dsh-power-switch

⚡ dsh-power-switch · 一键电源开关 🐋

你是不是也受够了？ 😤 装个插件——重启。卸个插件——重启。改行配置——还是重启。
一晚上下来插件没装几个，任务管理器倒是熟得像自己家 🏠

本鲸鱼小姐也是受害者 🐋💢 每次都要在一堆 node.exe 里大海捞针，捞错了把别的东西干掉，捞对了又忘了当初那行命令是啥……
于是气不过，自己写了一个 🔨

右上角多一枚电源键 🔘 点一下，DSH 进程真的没了 💀；再点一下，它真的又爬起来了 🧟

不是 location.reload() 🙅 不是 router.refresh() 🙅 更不是「转两圈假装重启好了」那种糊弄学 🎭 是这个进程真的从任务管理器里消失，然后一个新的它站起来 💪

而且不弹那个吓人的「宿主停止」框了 🎉 —— 这版专门把这个坑填了，下面有交代。

😩 这玩意儿到底救你于什么水火

装插件 🧩、改配置 ⚙️、调 patch 🩹 之后，DSH 十次有八次来一句：「重启一下才生效哦～」

然后你就开始了这套祖传行为艺术 🎪：

1. 🔍 翻到任务管理器
2. 🎲 在一堆 node.exe 里猜哪个是 DSH（纯玄学）
3. 💥 猜错一次，把别的东西干掉了
4. 😌 猜对一次，关掉
5. 🧠 忘了刚才的命令行是什么，凭记忆重敲
6. 🚫 端口被占，报错
7. 🌐 重开一个终端，dsh web，端口又变了，浏览器地址失效

一套下来十五分钟没了，插件还没生效 🙃

最气的是什么？ 你只是想卸载一个插件而已 😑 结果为了「让卸载生效」，你得先把自己这个正在用的 DSH 干掉。
……等一下，那我卸载完拿什么重新打开它？🤡

dsh-power-switch 就是为这一刻写的 ✍️ 把这一整套压缩成两次点击 👆👆（第二次是防误触，它有点礼貌，不是啰嗦）

👀 长什么样

会话头部右侧多一枚小电源图标 ⚡，不抢位置、不遮最小化 ➖ / 隐藏 👻 / 关闭 ❌ 那组窗口按钮（这点我盯得很死，谁也别想挤到它们）

点开是个小菜单，里面只有两个按钮，干干净净：

| 按钮 | 干了什么 |
| ⚡ 重启 | 结束整个 DSH（含桌面主进程），随后自动拉起一个全新的 🔁 |
| ⏻ 关闭 | 结束整个 DSH，不自动拉起，安静地走 🌙 |

两个按钮都要点两次 👆👆：第一次是「你真的想好了吗 🤨」，第二次才是「好，动手 🔨」

🎉 关于那个崩溃弹窗：这版把它干掉了

老版本会弹这个：

Error: dsh desktop host stopped: ...

新版本不会了 ✅ 因为这次杀的是桌面主进程，不是宿主子进程。

道理很直白 🧾：

- 那个弹窗是桌面外壳（主进程）弹的 —— 它盯着自己的宿主子进程，发现没了就报一次 📢
- 那就别让它有机会报啊 —— 把主进程一起送走 🔪
- 主进程都没了，谁来弹框？🤷♀️

剩下的收尾由宿主自己完成：主进程一死，宿主那边的 IPC 通道就断了，宿主监听着 disconnect，于是它自己走一遍正常关闭流程（会话日志好好落盘 📝），然后安静退出 😴

🔑 一句话记住：以前杀的是「儿子」，爸爸在旁边看着当然要哭；现在直接把「爸爸」请走，全家一起安静退场 🤐

🐛 试错记录（免得你也踩一遍）

| 方案 | 结果 |
| 只杀宿主子进程（老版本） | ⚠️ 功能没问题，但主进程必然报一次「宿主停止」 |
| 退出码设 0 想骗过它 | ❌ fail() 的两个分支都触发，文案从「exited」变「stopped」而已 |
| 想设 stopping 标志 | ❌ 那是主进程私有状态，插件够不到 |
| 找 IPC 白名单走正门 | ❌ 只认 ready / shutdown-complete / platform-session / fatal，没有重启入口 |
| 杀主进程（不带 /T） | ✅ 本次方案：没人能弹窗，宿主自己优雅退出 |
| 杀主进程带 /T | ❌ 会连宿主一起强杀，宿主来不及落盘，等于拔电源 🔌 |

那个 /T（连同子进程）看着更彻底，其实是坑 —— 不带它才是对的 🙅

🛠️ 它是怎么工作的（技术党进）

⚡ 重启

四段接力，没有任何魔法：

1. 自省 🪞：从 process.pid / process.ppid / process.execPath 现场问出「我是谁、我爸是谁、我是被哪个 exe 启动的」，不猜 profile 🙅 不写死 路径 🙅
2. 接力 🏃：拉起一个 detached 的 helper。它不在任何进程树里，所以父进程死光它也活着
3. 送走 🔪：helper 等一小会儿（先把 HTTP 响应吐完），然后 taskkill /PID <主进程> /F —— 注意没有 /T，只杀主进程本身
4. 重生 🧟：主进程没了 → 宿主因 IPC 断开自行优雅退出 → helper 等旧实例彻底走干净、端口空出来 → 用原 exe 拉起新实例 → 确认它真的画出了窗口 → 收拾上一轮残留 → helper 自己退出

为什么必须等干净？因为 Electron 有单实例锁（requestSingleInstanceLock）🔒 旧主进程没退利索就 spawn 新的，新实例会发现自己不是「老大」，直接 quit() 自杀 ——我实测过，369 毫秒就没了 💀 快到你以为它起来了，其实连窗口都没开。
所以 helper 会重试最多 5 次，每次间隔 3 秒 —— 手慢不要紧，起来就行 😌

环境变量要清干净 🧹：拉起前会把 ELECTRON_RUN_AS_NODE 和 DSH_DESKTOP_NODE_EXECUTABLE 删掉。
不删的话新实例会以 node 模式启动 —— 进程是起来了，但没有窗口，等于白起 🙃

👀 「进程还在」不等于「起来了」

这是这一版最较真的地方。

老版本判活：spawn 完等 5 秒，进程还在就算成功。
问题是 —— 进程在、窗口没画出来，这种半死不活的状态它照样报「重启完成」🙃 你对着一个没有窗口的任务管理器发呆，那才叫真尴尬 😑

现在查 MainWindowHandle，真的见到窗口才算数，最多等 30 秒，等不到就杀掉重来。
还有个细节 🧐：MainWindowHandle 有时查不到 —— PowerShell 没跟上、查询超时、权限抖动。
这种状态我记为 unknown，它不等于失败： unknown 就继续等，超时了只要进程还活着，就当它起来了。

宁可少杀一次，也别因为探测不到就把好好的实例打掉 🔪

🧹 顺带收拾残留进程

新实例窗口出来之后，会清掉上一轮剩下的进程（GPU / 渲染器 / 插件后台）。

这里我自己先踩了一脚 😵 一开始按「孤儿」定义清理 —— 结果 helper 本身也是用 DeepSeek Harness.exe 跑起来的，启动时间还更早，第一刀就把自己砍了 🔪 日志里 restart complete 后面干干净净，reap: 一行都没有，我才反应过来。
（所以你现在在老日志里看不到那行，是这么没的，不是我偷懒 😤）

现在判据是启动时间：新实例整棵树都晚于新主进程，按时间切绝对安全；并且显式排除 process.pid（自己）。

这也算 best effort 🤷♀️ 渲染器偶尔粘着不走，不保证 100% 清空，但正常情况下够用了。

⏻ 关闭

同一条路，只是最后不 spawn。主进程走人 → 宿主优雅退出 → 结束 🌙

🖥️ 前端为什么不用刷新

旧页面跟着旧进程一起消失了，刷新它没有意义 🙅 点完按钮就显示「正在关闭 / 正在重启」，然后等页面自己断线。
新实例起来是个新的地址、新的页面，从桌面应用或启动器进去就行。

如果十几秒后页面还活着 —— 说明那一下没生效，它会老实告诉你「没反应，再点一次？」🤔

🔒 安全边界

- 只接受同源 POST，跨站一律 403
- 端口只在本机 loopback 监听
- 除重启 / 关闭外没有任何其他动作

📦 安装

插件市场里搜 电源 🔌 / power ⚡，或者：

dsh plugin add dsh-power-switch

装完重启一次 DSH（对，就用它自己 😏 第一次得手动，之后就不用受这罪了）

⚠️ 装完按钮没出现？看这里

DSH 0.2 之后的加载链路是这样的：

package.json 的依赖 → dsh.profile.bundles[] 里有这个包名 → 读它的 cordis.patch.yml → insert 那一行 → 插件才真正挂载

光装依赖是不够的，还得在 dsh.profile.bundles 里登记。
否则 patch 根本不会被读 —— 文件都在，插件就是不存在 📦≠🔌

正常情况下 dsh plugin add 会帮你登记好。但如果：

- 你手动改过 package.json
- 或者 DSH 刚升级过（升级会重写 profile 配置）

那就检查一下 DSH_HOME/profiles/<profile>/package.json：

"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-power-switch" // ← 少了这行，插件就不会加载 ] } }

补上后重启 DSH 即可。（本插件在 0.1.5 就是被这个坑坑掉的 🩹）

🔍 自检：它到底加载了没

curl http://127.0.0.1:<port>/dsh-power-switch/api

看两个字段：

- version —— 实际加载的版本号
- build —— 我每次改代码手动更新的标记，用来确认跑的是不是最新那份

如果这个地址 404，基本就是上面那个 bundles 的问题。

🛡️ 安全边界

- ✅ 只接受同源 POST，跨站请求一律 403 🚫
- ✅ 端口只在本机 loopback 监听，没往外暴露一丁点
- ✅ 不做「顺便帮你跑个命令」这种扩展 —— 它就两个动作：重启 🔁、关闭 🌙
- ✅ 关闭按钮不会删你的会话、配置或插件，只是让进程退出（数据都在，放心）
- ✅ 双击确认，防手滑 🙌

🧩 兼容

- 🖥️ DSH Web 与 Desktop 双端
- 🪟 Desktop 下：杀主进程 → 宿主优雅退出 → 用 DeepSeek Harness.exe 拉起新实例
- 🐧 普通 dsh web / node bin.js 启动的宿主：没有 Electron 主进程，就直接结束宿主自身（这种形态本来也不会弹框）
- 📊 两种形态都由 GET /dsh-power-switch/api 的 facts / restartable 字段如实自报（它不会撒谎）

❓ 常见问题

Q：重启后还弹「宿主停止」吗？ 😰

不弹了 🎉 这版把弹框的源头（主进程）一起请走了，详见上面那节。
如果你还看到弹框，八成是装的是老版本 —— 升级一下就好。

Q：那我现在怎么知道重启成功了？ 🤔

页面会自己断掉，然后你从桌面应用重新进 —— 看到界面就是成功了 ✅ 没成功的话 helper 会弹一个原生提示框告诉你「应用没起来，请手动启动」，不会闷声装死 🤐

Q：为什么要杀主进程，不能温和一点吗？ 🥺

试过了，温和不了 🙇 主进程对「宿主消失」这件事的反应是写死的：不管退出码是 0 还是非 0，都会报一次。插件跑在子进程里，碰不到它的私有状态。
所以换个思路 —— 既然它一定要报，那就让它没机会报 😤

Q：那我为什么还要用这个插件？ 🤔

因为它就在会话头部，两下点击，不用翻菜单；而且它同时提供「关闭」 —— 现有同类插件几乎都只做重启。

Q：重启后端口变了，我原来的浏览器地址打不开了？ 🤔

正常 🙂 DSH 会自己挑端口。重新从桌面应用或启动器进入即可。

Q：能批量重启多个 DSH 吗？ 🤖

不能，它只管当前这一个进程。想开多个请用多 profile，别指望它变集群管理器 😅

Q：关闭之后数据会丢吗？ 💾

不会 🙅 会话、配置、插件全都在磁盘上躺着。关闭只是让进程退出，不是删库跑路 🔥 而且宿主走的是自己的优雅关闭流程，日志会好好落盘 📝

📣 更新公告

每次改了什么、修了哪个坑，都记在 CHANGELOG.md 里 🗒️

🔬 自检

curl http://127.0.0.1:<port>/dsh-power-switch/api

返回里能看到当前 pid 🆔、port 🔌、platform 🖥️、restartable ✅

它不会撒谎 —— 如果 restartable: false，说明它没找到 Electron 主进程（比如跑在纯 Web 形态下），这时候它会拒绝重启，而不是瞎猜 🙅♂️（宁可不动，也不乱动，这点很讲究）

📄 License

MIT。真的杀了，别怪它 🔪😌

🐋 鲸鱼小姐的补充说明

这插件是我自己写的，因为我自己也烦透了每次都要去任务管理器里玩「猜猜哪个 node 是 DSH」🎲 现在它只要两下点击 👆👆 剩下的时间可以拿去干饭 🍚

那个崩溃弹窗我盯了好几轮才搞定 😤 一开始只杀宿主，弹框照旧；后来发现弹框是主进程弹的 —— 那就把主进程也送走呗，简单粗暴但有效 💥

中间那几版试错（包括那个差点把宿主强杀的 /T）我都记在上面了，省得你也踩一遍 🩹

主人的机器，主人说了算 🔘 按吧，坏了算我的（啊不，坏了算它自己的 😤）