mirror of
https://github.com/wwiinnddyy/LanMountainDesktop.git
synced 2026-06-20 23:54:26 +08:00
927dc8d1fd
Introduce a launcher coordinator to reserve startup ownership and prevent duplicate host launches. Adds a NamedPipe-based IPC server/client (LauncherCoordinatorIpcServer/Client), coordinator messages/models, and PublicShellStatus/activation types for richer shell reporting. Enhances StartupAttemptRecord and StartupAttemptRegistry to track coordinator pid/pipe, heartbeat, reserved-before-host-start, and public IPC status, plus new reservation/heartbeat APIs and takeover logic. Wire coordinator into App and LauncherFlowCoordinator to attach secondary launchers, publish coordinator status, probe existing hosts, and include more detailed launch result details. Also adds unit tests and docs describing coordinator and startup visuals behavior.
2.2 KiB
2.2 KiB
Launcher Coordinator And Always-On Tray Addendum
Launcher-to-launcher coordination
- Launcher reserves startup ownership in
%LocalAppData%\LanMountainDesktop\.launcher\state\startup-attempt.jsonbefore it starts the host process. - The reserved record includes
CoordinatorPid,CoordinatorPipeName,HeartbeatAtUtc,PublicIpcConnected,ShellStatus, andReservedBeforeHostStart. - Only the active coordinator may call
Process.Start()for the host. Secondary Launchers attach to the coordinator pipe and request desktop activation or status. - If the coordinator heartbeat is newer than
10sand the coordinator pid is alive, a new Launcher must not take over. - If the coordinator is stale, the next Launcher may take over the same pending attempt instead of creating a second host attempt.
- Normal launches probe Host Public IPC first. If a host is already running, Launcher activates that instance and exits without starting another host.
Finer shell status
- Public shell IPC exposes
GetShellStatusAsync(),ActivateMainWindowWithStatusAsync(),EnsureTrayReadyAsync(), andEnsureTaskbarEntryAsync(). PublicShellStatusseparates process, shell state, main-window visibility, tray health, taskbar-entry health, and Public IPC readiness.- Launcher success/failure details must include coordinator pid, attempt id, host pid, Public IPC status, tray state, and taskbar usability when available.
Always-on tray and taskbar repair
- The tray icon and menu are mandatory application-liveness indicators and are not controlled by user settings.
- Tray watchdog starts during shell initialization and keeps running until application exit.
ShowInTaskbar=truemeans hidden/background states preferMinimizedToTaskbar; it never disables the tray.ShowInTaskbar=falseis the only mode that may enter pureTrayOnly, and only afterTrayReady.- When taskbar entry is requested but missing, shell repair recreates or shows the main window minimized with
ShowInTaskbar=truewhile keeping the tray visible.
Regression coverage
- Unit tests cover active coordinator rejection, stale heartbeat takeover, and host-pid assignment after a reserved attempt.
- Manual QA still needs multi-process Launcher concurrency and real tray loss simulation on Windows.