sgc-electron-app-relaunch

# Electron 应用重启 为用户提供真正重启桌面应用的入口，并在开发态、生产态和更新安装时保持正确的进程生命周期。 ## Triggers ### Activate when - 用户说“在菜单里增加重启 App”“实现重启 Yoda”或“完整重启 Electron”。 - 用户把 `Cmd+R`、reload、relaunch、退出再打开混在一起，需要修复实际行为。 - User asks to “restart the app from a menu”, “use app.relaunch”, or “make Electron dev restart reliable”. ### Do not activate when - 用户只需要刷新页面或恢复某个 renderer 错误边界；使用 renderer reload。 - 用户要重启某一条 Agent/终端会话；使用会话生命周期或 PTY 工作流。 ## Workflow (MANDATORY) **You MUST follow these steps in order.** ### Step 0: Name the intended action - Map every proposed UI entry to exactly one intent: renderer reload, full app relaunch, or update installation handoff. - Do not bind a standard reload shortcut to full relaunch by accident. In Electron, the built-in View reload role commonly owns `Cmd+R` / `Ctrl+R`. - Read [references/relaunch-contract.md](references/relaunch-contract.md) before implementation. ### Step 1: Centralize the relaunch path - Put full-app restart in one main-process function, then invoke it from the native menu or typed IPC. - In packaged production, call `app.relaunch()` followed by `app.quit()`. - In development, relaunch the actual dev entrypoint with the Node executable and arguments that started the app; do not assume a packaged executable exists. - Keep renderer reload separate and label it accordingly in the UI. ### Step 2: Preserve process ownership - Let main-process shutdown hooks complete according to the product's session policy. - Do not use the ordinary relaunch ...