AGS项目在系统挂起后窗口异常问题分析与解决方案

问题现象分析

在Hyprland桌面环境下使用AGS（Aylur's Gnome Shell）时，用户报告了系统挂起恢复后的异常行为。具体表现为两种典型场景：

1. 挂起后等待2秒以上恢复：AGS工作正常
2. 立即唤醒系统：AGS界面消失但进程仍在运行（显示"Ags with busname 'ags' is already running"）

进一步测试发现，问题本质是挂起恢复后所有窗口实例被意外销毁，而AGS主进程保持运行。这种现象与Hyprland的显示器管理机制密切相关。

根本原因

通过深入分析，发现问题源于Hyprland的显示器事件处理机制：

1. 系统挂起时，显示器会被临时移除
2. Hyprland触发"monitor-removed"事件
3. AGS默认会销毁该显示器上的所有窗口
4. 恢复时虽然显示器重新连接，但AGS不会自动重建窗口

技术解决方案

基于对问题的理解，我们可以在配置中增加显示器添加事件的监听处理。以下是改进后的核心代码实现：

const hyprland = await Service.import("hyprland")

hyprland.connect("monitor-added", (_hypr, monitor) => {
    // 获取显示器ID
    let id = hyprland.monitors.find(m => m.name === monitor)?.id || 0
    
    // 检查窗口是否已存在
    const windowExists = App.windows.some(w => w.name === `bar-${id}`)
    
    // 不存在则创建新窗口
    if (!windowExists) {
        App.addWindow(Bar(id))
    }
})

实现原理详解

1. 事件监听：通过Hyprland服务的"monitor-added"事件，捕捉显示器重新连接的时机
2. 状态检查：验证对应ID的窗口是否已经存在，避免重复创建
3. 窗口重建：当确认窗口丢失时，重新实例化窗口组件

最佳实践建议

1. 异常处理：建议在代码中加入try-catch块，处理可能的异常情况
2. 日志记录：添加调试日志，便于问题追踪
3. 性能优化：对于多显示器环境，可以考虑批量处理窗口重建
4. 状态保存：复杂场景下可考虑保存窗口状态，恢复时保持一致性

总结

这类问题在Wayland合成器环境下较为常见，理解合成器与客户端的交互机制是关键。通过事件驱动的编程模型，我们可以有效解决系统状态变化带来的界面异常问题。此解决方案不仅适用于挂起恢复场景，也可推广到其他显示器热插拔场景。

对于AGS用户，建议在配置中加入完善的显示器事件处理逻辑，以增强应用在动态环境中的稳定性。同时，这也展示了现代Linux桌面环境中客户端与合成器深度集成的编程模式。