macOS 桌面版重启（dsh-macos-restart）
English | 中文
macOS 桌面版一键重启：让无法热加载的插件在下次启动时生效。
这是 DeepSeek Harness 桌面版 的 macOS 一键重启插件。它处理 Electron 应用本身，不是 dsh web 宿主：重启的目的是让无法热加载的插件在下一次启动时加载。
范围
仅适用于 macOS 桌面版。 它不是通用的标题栏控件，也不是 dsh web 的重启按钮：
- 结束 Electron 主进程，让桌面 host 通过自己的 IPC 断开路径退出；等待旧 web 端口释放后，对
.app执行open -a。 - 不支持 Windows、Linux、
dsh web或独立dshCLI。 - 刻意不提供“退出”动作；macOS 已有 Cmd+Q。这里的价值是自动重新拉起、运行中任务检查和插件安装门禁。
社区插件 dsh-header-controls 也会在会话标题栏放重启/退出按钮，但它文档中的机制是 dsh web launcher + Windows taskkill/netstat 流程，不会重启 macOS Electron 应用。两者只在“标题栏位置”这一层重合。
入口
- 标题栏图标：会话右上角，默认开启。
- 侧栏底部图标：设置按钮旁，默认关闭，可在设置里打开。
- 设置 → 桌面版重启：状态、上次重启、日志、入口开关和重启按钮。
/restart-desktop命令；有任务运行时用--force。- 可拖动的浮动按钮：默认关闭，位置会记住。
标题栏、侧栏、浮动按钮、设置页和命令都调用同一个 Host 操作。
重启过程
- 客户端向
POST /plugins/dsh-restart/restart发送{ "confirm": true }。 - Host 检查请求是否来自 loopback/同源、当前是否为 macOS 桌面 host、是否有插件安装/更新在跑、是否有任务在运行。
- Host 写 handoff 记录和初始
state.json，然后启动一个独立的 one-shot opener（detached/bin/sh）。opener 只等待和打开，不杀进程。不要使用launchctl submit：0.1.4 真机测试中，这个 job 会在应用回来后每约 10 秒重复拉起 opener。 - Host 启动 killer helper。它向 Electron 主进程 发送 SIGTERM。应用可能会弹出自己的退出确认（定时任务）；点“退出”会让它保存账号/会话状态。host 是独立子进程，会看到 IPC 通道关闭并走自己的优雅关闭，所以会话日志仍会落盘。正常重启不会升级到 SIGKILL——取消必须真的取消，未回答的弹窗也不能被静默强杀。如果 SIGTERM 后 3 秒 主进程 仍活着，helper 会记录
cancelled，opener 不打开，弹窗显示 重启已取消。如果主进程已经退出、只是旧 host 还在落盘，helper 会继续等 host，不记为取消——此时 opener 可能已经把应用重新拉起来了。只有显式的 stale-manager 高级路径会用 SIGKILL，并带自己的警告。 - opener/killer 等待旧主进程消失、旧 web 端口释放，然后执行
open -a "/Applications/DeepSeek Harness.app"。open -a对已在运行的应用只是激活，所以两个 helper 不会启动两个实例。 - 正常重启如果 host 不退出，会取消而不是升级；只有显式的 stale-manager 强制路径会升级。失败时弹窗提示，日志在
~/.dsh/dsh-restart/。
诊断
~/.dsh/dsh-restart/state.json记录上次重启的阶段：queued → opener-started/killing → waiting-host → host-exited → waiting-port → port-free → opening → opened（或failed）。- 设置页显示上次阶段/时间，并提供一个 在 Finder 中显示最近日志 按钮。
POST /plugins/dsh-restart/open-logs从 Host 做同样的事，所以页面断开后也能用。它使用open -R（Finder 显示并定位），因为直接open .log依赖默认应用，可能看起来没反应。 - helper 日志包含进程级记录；state 文件是进程树被清理后仍能保留的简要版本。
卡住的安装恢复
如果插件管理器持有安装锁、且五分钟内没有任何 pnpm/安装进展，状态会变成 pluginOperation.stale，弹窗会出现 强制重启（高级）。这个入口只在锁属于当前 host，或根本没有 manager 锁时出现；不会绕过仍在运行的 pnpm 进程。强制重启会结束 host、释放锁并重开应用，未完成的安装会被中断；由于它绕过应用自己的退出确认，主进程可能不会完成最后的账号/窗口状态落盘。只在 manager 确实卡住时使用。
安全
- 只接受 loopback 请求。桌面文档代理可能同时去掉
Host/Origin，也可能只去掉Origin；loopbackHost且没有Origin会被接受，带Origin时必须与Host匹配。sec-fetch-site: cross-site会被拒绝。 - 有任务运行时返回
409 busy；客户端列出受影响的会话 id，并要求二次确认后才发送force: true。 - 插件安装/更新中返回
423；唯一例外是上面描述的“stale manager 锁”高级强制路径。 cordis.patch.yml里allowRestart: false可完全禁用。- 插件不修改
app.asar，也不会启动第二个服务器。
配置
- id: dsh-restart
name: 'dsh-macos-restart'
config:
allowRestart: true
文件
lib/index.js— Host 路由（/status、/restart、/open-logs）、门禁、命令、state、helper/opener 调度。lib/helper.sh— detached killer/opener helper（支持--dry-run）。lib/client.js— 标题栏图标、侧栏按钮、设置页、弹窗、浮动按钮、日志操作。locale/{en,zh}.json— 插件管理器显示元数据。README.md— 英文 README。PUBLISHING.md— npm + curated catalog 发布清单。
发布
见 PUBLISHING.md。当前包名 dsh-macos-restart 是本地开发名；可发布的包是 npm 上的 dsh-macos-restart。
