标题栏重启 geitaHer0/dsh-plugin-desktop-restart

dsh-plugin-desktop-restart

中文简介

在 DeepSeek Harness 桌面窗口的标题栏（「应用 / 编辑」同一行）右侧加一个重启按钮：第一次点击变为「确认重启」，再点一次才真正重启应用，避免误触中断正在运行的任务。

- 重启由 Electron 外壳执行，插件通过打过补丁的 window.dshDesktop.restart() 调用；
- 应用更新会替换 app.asar，补丁与按钮随之消失；用 tools/patch-shell-restart.mjs 重新打补丁即可恢复；
- 按钮只在桌面应用窗口渲染（普通浏览器页面没有该桥接，不会显示）；
- 补丁原理与字节长度保持细节见下方英文小节。

DeepSeek Harness Web GUI 侧边栏底部、账户额度标签旁边有一个 Restart 按钮。

为什么必须给应用打补丁

重启是 Electron 外壳的职责——只有它能重新拉起进程——而外壳向页面只开放一条通道：预加载桥接（window.dshDesktop）。这条桥接没有提供重启方法，外壳自带的「Restart App and Host」菜单项又藏在 development 标志后面，插件够不着。因此本插件需要在应用的 resources/app.asar 里做两处等长修改，由 tools/patch-shell-restart.mjs 完成：

| 文件 | 改动 |
| /lib/main.js | 加一个 dsh-desktop:restart IPC 处理器，校验发送方后调用 app.relaunch(); quitWithoutConfirmation()——外壳自己的重启写法。 |
| /lib/preload-app.cjs | 在 dshDesktop 桥接上挂 restart()，让页面能调用那个处理器。 |

两处改动都保持文件字节长度不变（各自插入代码，再改写一段注释块，正好抵消同样多的字节），所以 ASAR 里的偏移量不会移动，其他文件也原样不动。

应用更新会替换 app.asar，补丁随之丢失；按钮也会自己消失，因为它只在桥接确实提供 restart 时才渲染（见下文）。用同一个工具重新打补丁就能恢复。

按钮做什么

它位于 Windows 标题栏菜单栏，也就是应用窗口顶部、已经放着 应用 / 编辑（Application / Edit）的那一行。

这一行由桌面预加载构建，不是 Web 客户端：它是一个 div[data-windows-menu]，带 open 模式的 shadow root，里面有一个 和 div[role=menubar]，每个菜单一个按钮。open 模式正是这次不用再给外壳打补丁就能放按钮的原因——插件通过 host.shadowRoot 拿到菜单栏，追加自己的 ，shadow 树里的元素样式会把它打扮得和自带按钮一模一样。所以插件完全不带 CSS。

- 它只在 window.dshDesktop.restart 是函数且标题栏那一行存在时渲染。用回环 URL 当普通页面打开时，既没有桥接也没有标题栏，于是什么都不加，而不是加一个点了没用的按钮。外壳浮层出现后，预加载才挂载那一行，所以插件会盯着它（一个 MutationObserver 加一个慢轮询，两者都随插件一起销毁）。
- 确认逻辑就写在按钮自己的文字里：第一次点击把 重启 变成 确认重启（用警告色着色），只有第二次点击才会向 shell 重新启动。shell 的重新启动路径不会询问进行中的工作，所以少了这一步，一次误点就会丢弃正在运行的任务。点击其他任何位置都会撤回确认。
- 请求进行中时，标签显示 正在重启…；请求被拒绝时，标签会报告该情况，并记录到控制台。
- 标签通过客户端 locale 服务跟随界面语言，按钮不进入菜单栏的漫游 tab 顺序（tabIndex = -1）。

布局

| 路径 | 作用 |
| lib/client.js | 整个功能：标题行的挂载、按钮、它的确认，以及 zh/en 词典。 |
| lib/index.js | 宿主侧——空的 apply；这一行只需存在，浏览器侧才能被提供。 |
| cordis.patch.yml | 打包补丁，按裸包名插入 desktop-restart 行（用子路径会让浏览器侧无法解析）。 |

安装与验证

把包注册为配置档打包（cordis.patch.yml），然后重启 DSH，让客户端行被组合出来。shell 补丁用本仓库自带的工具应用：

rehearse on a workspace copy (the real archive is not touched)
node tools/patch-shell-restart.mjs "D:/DeepseekHarness/resources/app.asar"

back up, install, re-verify; restores the backup automatically on any doubt
node tools/patch-shell-restart.mjs "D:/DeepseekHarness/resources/app.asar" --apply