@shawnxiaoyang/dsh-tray-restart
让桌面端托盘的「重启 DeepSeek Harness」项在每次自动升级后自动回来。
它会修改官方安装包。 本插件会在你退出应用后,把
resources/app.asar换成一份 打过补丁的副本(原档备份为app.asar.heal.bak)。这属于修改已安装程序,可能触发杀软 告警;如果上游开启了归档完整性校验,插件会拒绝动手(见下文「安全闸门」)。
它解决什么问题
桌面端(DeepSeek Harness.exe)的托盘右键菜单写在 Electron 主进程里,也就是打包进
resources/app.asar 的 lib/main.js。nightly 更新是整包替换:升级后 app.asar
被换回官方原版,托盘菜单里就只剩「打开」「退出」。
托盘菜单属于主进程,插件体系碰不到它(主进程的 Tray、没有 restart 类 IPC、渲染进程
发来的消息还要过 dsh-app: 协议校验)。所以本插件不试图"添加菜单项",而是修好那个
装着菜单项的归档文件——在 Windows 唯一允许替换它的时刻:应用退出之后。
安装
dsh plugin --profile desktop add @shawnxiaoyang/dsh-tray-restart
装好后重启一次应用即可。只在 Windows 桌面端生效:macOS / Linux 的桌面端、以及终端里
dsh web 起的 CLI 形态都没有这套托盘,插件会报告自己空闲并什么都不做。
工作方式
- 发现:宿主进程是 Electron 主进程的直接子进程,
process.execPath和process.resourcesPath就是应用自己的。读resources/app.asar里的lib/main.js就能判断补丁还在不在。 - 暂存:一个子进程在原归档旁边重建出打过补丁的
app.asar.heal.new。它从不碰app.asar;任何一处锚点对不上就整体放弃,不产出半成品。 - 换包:一个分离的守护进程等 Electron 主进程退出,再核对归档仍是当初构建补丁的那 一份(哈希不符说明升级换过了,直接丢弃暂存包,绝不覆盖新版本),然后才把暂存包写进去。 写完校验,失败就从备份还原。
/restart 补上运行中的一环:暂存 → 布防 → 由守护进程停掉应用并重新拉起。
CLI 形态的 Harness(终端里 dsh web)没有 Electron 外壳,插件会报告自己空闲并什么都不做。
安全闸门
补丁改的是官方归档,所以有两道闸门在写之前就拦住:
- 归档完整性校验(Electron fuse
EnableEmbeddedAsarIntegrityValidation)。开启时 Electron 会拿头部记录逐条校验打包条目,重建的归档必然对不上签名版本,结果是应用 退回默认 Electron 窗口、整个用不了。插件因此先读可执行文件里的 fuse 位:只要不是 明确关闭,就一律拒绝写入(读不到也算不安全)。当前桌面端 0.2.2-rc.3 是关闭的。 - 锚点唯一性。每处改动都要求目标文本在
lib/main.js里恰好出现一次;官方改写结构 后会报anchor-failed并指出是哪一处,不会产出坏包。
设置页会把这两件事的状态直接显示出来。
使用
正常使用时不需要做任何事:升级后第一次启动,插件在 4 秒后重建暂存包,等你下次正常退出 应用时静默换包,再下次启动托盘项就回来了。
想立刻生效,在会话里输入:
/restart
它会重启应用,并顺带把托盘「重启」项修回来。
设置页
插件管理里这一行的设置页是只读的,显示:补丁是否在位、桌面端版本、lib/main.js 字节数、
暂存包是否备好、重建用的运行时、归档完整性校验是否开启,以及最近 40 行日志。它通过宿主
的只读回环路由 /__tray-restart/status 取数(非回环、跨站、DNS rebinding 一律 403),
页面本身没有任何写入路径。
配置
| 键 | 默认 | 含义 |
|---|---|---|
enabled |
true |
启用本插件 |
autoHeal |
true |
启动时若发现补丁丢失,就在后台重建并暂存 |
restartCommand |
true |
注册 /restart 命令 |
状态与日志
- 日志:
%LOCALAPPDATA%\dsh-tray-restart\heal.log - 暂存包:
<resources>\app.asar.heal.new - 换包备份:
<resources>\app.asar.heal.bak - 守护进程锁:
<resources>\app.asar.heal.lock
边界与已知代价
- 补丁依赖
lib/main.js里的若干锚点文本。新版桌面端改写了这些位置时,插件会报告anchor-failed并给出是哪一处,而不是产出一个坏包。把那条消息发出来即可适配。 - 换包发生在应用退出之后,因此升级后的第一次退出才会真正生效,不是升级瞬间。
- 换包用"覆盖写"而不是"改名":Windows 会拒绝给仍被映射的大文件改名,但允许覆盖写。 代价是归档有一瞬间是半写状态,因此备份先写好并校验,失败就回滚。
- 暂存包约 200 MB,构建耗时 1–2 秒,退出时会占一点磁盘 IO。
- 需要系统里有一个 Node.js 来跑重建子进程(找不到时回退到应用自带的 Electron node 模式)。
卸载
从 profile 里移除本插件后,resources/app.asar 会保持最后一次换包后的样子(仍是打过
补丁的归档)。想恢复官方原版,用 app.asar.heal.bak 覆盖回去,或者重装一次桌面端。
许可
MIT
No comments yet. Be the first to write one.