DSH Tray Restart
在 Windows 系统托盘菜单中增加 重启 DeepSeek Harness，一键关闭并重新启动整个桌面应用。
打开 DeepSeek Harness
重启 DeepSeek Harness
────────────
退出 DeepSeek Harness
> 当前适配 DeepSeek Harness Desktop 0.2.1-rc.3，支持 Windows 10/11。
功能
- 在 DSH 原有托盘菜单中插入“重启 DeepSeek Harness”，不创建第二个托盘图标。
- 点击后调用桌面端现有的
app.relaunch()和quitWithoutConfirmation()：先正常关闭 Host、窗口和托盘，再重新启动应用。 - 托盘菜单的其他项、DSH 主界面和其它菜单保持不变。
- 文案跟随 DSH 当前语言：中文为“重启 DeepSeek Harness”，英文为“Restart DeepSeek Harness”。
安装
从插件市场安装
插件上架后，在 DSH 的 插件 → 发现 / 插件市场 搜索“Tray Restart”并安装。
从 GitHub 安装
仓库地址：
让 Agent 使用 plugin_manager 从该 GitHub 仓库安装，或把仓库克隆到本地后按下一节从本地目录安装。
从本地目录安装
在 DSH 插件管理中使用 plugin_manager 安装本目录：
plugin_manager action=install_bundle
target=<本目录绝对路径>
安装后插件会在当前 desktop profile 中启用。
使用
- 安装插件。
- 完全退出 DeepSeek Harness，再重新打开。当前正在运行的 Electron 主进程已经加载了旧的托盘代码，必须重启一次才能看到新菜单。
- 右键 Windows 系统托盘中的 DSH 图标，点击 重启 DeepSeek Harness。
> “重启”与桌面端开发菜单中的“重启应用与 Host”使用同一套逻辑，会跳过退出确认；正在运行的任务会被中断，Host 会先执行正常关闭流程。
实现方式
DSH 没有向插件暴露系统托盘菜单 API，托盘由 Electron 主进程直接创建。因此这个 Host 插件在激活时对桌面安装目录中的 resources/app.asar 做一次等长、幂等的补丁：
- 只替换
lib/main.js中的DesktopTray区域； - 替换后文件长度不变，所有 asar 条目的偏移量保持有效；
- 同步更新 asar 头中
lib/main.js的 SHA-256 完整性记录； - 已是最新补丁时直接跳过；旧版本补丁会原位升级，不会重复插入；
- 在 Electron 中使用
original-fs绕过 asar 路径拦截。
补丁只增加一个托盘菜单项，不会联网、不会读取会话内容，也不会修改 DSH 的其他行为。
兼容性
- 需要 Windows；托盘菜单本身是 Windows 桌面端功能。
- 当前针对 DSH Desktop
0.2.1-rc.3的DesktopTray实现。 - 如果 DSH 升级后托盘实现或必要的
app.relaunch()/quitWithoutConfirmation/restartApplication标识发生变化，插件会拒绝写入并记录警告，而不是生成一个可能出错的菜单。 - DSH 自动更新会覆盖
app.asar；下次启动插件会自动重新打补丁。由于托盘代码先于插件加载，更新后的第一次启动仍显示旧菜单，再重启一次即可看到新菜单。
安全与权限
- 需要 DSH 安装目录可写。若 DSH 安装在
Program Files等受保护目录，补丁会失败；请使用用户级安装，或以足够权限运行一次。 - 插件修改的是桌面壳的
app.asar，属于安装目录级别的变更，不是普通 UI 插件。安装前请确认你接受这一点。 - 补丁的写入是幂等的；同一版本重复启动不会重复修改。
故障排查
| 现象 | 处理 |
|---|---|
| 托盘菜单没有“重启 DeepSeek Harness” | 确认已完全退出 DSH 后重新打开；只关闭窗口会隐藏到托盘，不算退出。 |
| 插件显示已安装但没有生效 | 检查插件是否处于 active；查看 DSH Host 日志中是否有 could not add Restart DeepSeek Harness... 警告。 |
安装在 Program Files 下失败 |
安装目录不可写，改用用户级安装或给安装目录授予写权限。 |
| DSH 更新后第一次启动没有新菜单 | 退出再启动一次，插件会在新版本上重新打补丁。 |
卸载
禁用或移除插件会停止后续自动补丁，但不会主动移除已经写入当前 app.asar 的托盘项。安装新版本 DSH 会随应用文件一起恢复原状。若需要立即恢复，可在 DSH 更新后重新启动，或用备份的原始 lib/main.js 还原。
开发与测试
# 语法检查
node --check index.js
node --check tray-patch.js
# 单元测试（补丁、幂等、旧版升级、兼容性拒绝）
npm test
# 检查本机安装是否已打补丁、文案是否正确、asar 完整性是否匹配
npm run check:install -- "C:\Users\\AppData\Local\Programs\DeepSeek Harness\resources\app.asar"
测试只构造内存中的 shell 片段，不会修改本机 app.asar。
文档
- 插件文档（实现、兼容性、安全、验证）
- 插件市场条目与提交说明
License
MIT
