电源控制 w17her/dsh-power-control

dsh-power-control

在 DeepSeek Harness 桌面应用自己的窗口里就能刷新、重启或关闭它——不用去任务栏，也不用翻托盘图标。

一个轻量、零依赖的 DSH 插件：侧边栏底部一个电源按钮，一个菜单，一个确认对话框。刷新在任何 DSH 界面都能用；重启和关闭只支持 Windows 桌面版，因为应用进程树就在那里。

在 DSH 界面里直接「刷新界面 / 重启应用 / 关闭应用」，不用再去任务栏关窗口。
刷新在任何 DSH 环境都能用；重启与关机只支持 Windows 桌面版。

下载

- 可安装包：dsh-power-control-1.0.0.zip —— 解压后安装文件夹（见下文）。
- 或者克隆本仓库 —— 仓库根目录就是插件：package.json、index.js、 client.js、cordis.patch.yml、locale/、icon.svg。没有构建步骤，也没有编译产物要下载。

功能

| 操作 | 效果 |
| 刷新窗口 | window.location.reload() —— 从运行中的 Host 重建 Web 界面。 |
| 重启应用 | 把打开的会话写入磁盘，然后重启整个桌面应用（同一可执行文件、同一配置档、同一工作区）。 |
| 关闭应用 | 把打开的会话写入磁盘，然后退出整个桌面应用。 |

- 侧边栏底部一个 40 px 电源按钮，就在「设置」旁边。
- 菜单向上弹出，是覆盖整个框架的浮层，侧边栏滚动容器裁不到它。
- 破坏性操作先确认；确认框会写明究竟会中断什么。
- 进程退出期间，一层状态遮罩盖住窗口；如果 9 秒后进程还活着，会给出兜底的「刷新此窗口」链接。
- 适配浅色/深色：所有颜色都取自 DSH 主题 token（--dsw-alias-）。
- 中英文界面，跟随当前 DSH 语言环境。

环境要求

- Windows 10/11。
- 重启和关闭需要 DeepSeek Harness 桌面应用（Electron 外壳）。
刷新操作在任何 DSH 界面都能用。
- 插件管理器能加载本地包（标准 DSH 插件界面）。

安装

本插件是本地 DSH 包，不是 npm 包。两种方式都行：

方式 1 —— 发布 zip。 下载 dsh-power-control-1.0.0.zip，解压，然后用 DSH 的插件管理器安装解压后的文件夹（也就是包含 package.json 的那个）：

plugin_manager install_bundle target = <path to the unzipped dsh-power-control folder>

方式 2 —— 克隆。 克隆到一个固定位置，再安装同一个文件夹：

git clone https://github.com/w17her/dsh-power-control.git "$env:USERPROFILE\dsh-power-control"

两种方式下，DSH 都会把该目录链接进当前配置档并重载 Host，电源按钮随即出现在侧边栏底部。在图形界面里，设置 → 插件 同样显示同一条目；从未发布到注册表的包，支持的安装方式是从本地文件夹安装。

更新克隆：git pull。客户端改动会热重载；Host 改动需要把插件关掉再打开（或重启应用）。

卸载

在 Settings → Plugins 里禁用插件，或让你的 DSH 智能体卸载包 @local/dsh-power-control。DSH 配置档之外的东西一概不动。

工作原理

DSH 的桌面外壳不给页面提供退出或重启通道。主窗口的 close 被拦截，改成「隐藏到托盘」；Host 进程是 Electron 主进程的子进程：Host 自己退出，父进程会当成崩溃，弹出致命错误恢复对话框。

所以插件把这件事拆成两半：

1. Host 半（index.js，ESM）注册一条路由 POST /__dsh-power，请求体为 { "action": "probe" | "restart" | "shutdown" }。它：
- 校验调用方来自桌面外壳代理（同源还不够，外来 Origin 一律拒绝），
- 确认桌面目标：先看 DSH_DESKTOP_NODE_EXECUTABLE，否则用 Get-Process -Id <ppid> 查父进程映像，父进程不是同一个可执行文件就拒绝执行（正是这一步保住了终端里的 dsh web），
- 冲刷打开的会话（ctx.get('sessions') → flush），限时 3 秒，
- 返回 200，然后拉起一个分离的 PowerShell 辅助进程并返回。辅助进程活得比 Host 久，这正是关键：只有它能杀掉整棵进程树。
2. 客户端半（client.js，window.__ModuleLoader__）在 sidebar.footer.action 渲染按钮和菜单，在 shell.overlay 渲染菜单与确认浮层。

辅助脚本放在 %TEMP%\dsh-power-\power.ps1，日志写到 %TEMP%\dsh-power-control.log，先等 700 ms 让 HTTP 响应落地，再执行 Stop-Process -Name <image> -Force。重启时，它等旧实例消失（最多 30 秒），清掉仅桌面端使用的环境变量，再 Start-Process 启动可执行文件——旧实例还活着时绝不启动第二个实例，两个实例不会争抢配置档锁。

这里刻意不用 taskkill：它在这个场景不可靠（PID 已经不存在了也可能报 Access denied），Stop-Process 则表现正常。

安全与限制

- 运行中的任务会被中断。 重启和关机都会结束应用；确认对话框里写明了这一点。会话会先冲刷，但进行中的工具调用之后不会续上。
- 应用关闭期间，计划任务不会运行。
- 路由只接受经桌面外壳代理到达的请求，且只监听回环地址；从不信任远程 Origin。
- 插件自身没有网络客户端，不向任何地方发送数据。
- 与 DeepSeek 无隶属关系，也未获其背书。

仓库结构

index.js 宿主端：/__dsh-power 路由和辅助启动器 client.js 客户端：侧边栏按钮、菜单、确认浮层 cordis.patch.yml 打包补丁，把插件插入配置档 locale/en.json 插件显示元数据（英文） locale/zh.json 插件显示元数据（中文） icon.svg 插件图标

许可证

MIT — 见 LICENSE。