在mylinuxforwork/dotfiles中优雅终止Hyprland客户端进程的最佳实践

问题背景

在使用基于Hyprland的桌面环境时，用户经常会遇到一个常见问题：通过电源菜单执行关机、重启或退出会话时，客户端应用程序无法优雅终止。这会导致某些应用程序（如Google Chrome）在下一次启动时出现"未正常关闭"的警告提示，影响用户体验。

问题根源分析

在Hyprland桌面环境中，当用户通过电源菜单执行系统操作时，系统会直接终止整个会话。这种粗暴的终止方式会导致运行中的客户端应用程序无法完成正常的清理和保存工作流程。特别是对于像浏览器这类需要维护复杂状态的应用程序，这种非正常终止可能会导致数据丢失或状态异常。

解决方案设计

为了解决这个问题，我们需要在系统执行关机/重启/退出操作前，先向所有客户端应用程序发送终止信号，并给予它们足够的时间完成清理工作。具体实现方案如下：

1. 获取客户端进程列表：通过hyprctl命令获取当前会话中所有客户端的进程ID
2. 发送终止信号：向每个客户端进程发送SIGTERM信号（kill -15），允许它们优雅退出
3. 等待进程终止：设置合理的超时时间，等待所有进程完成退出
4. 执行系统操作：在所有客户端退出后，再执行实际的系统操作

实现代码详解

以下是经过优化的实现代码，关键点包括：

terminate_clients() {
  # 设置10秒超时，平衡用户体验和等待时间
  local TIMEOUT=10
  local start_time=$(date +%s)
  
  # 获取所有客户端进程ID
  local client_pids=$(hyprctl clients -j | jq -r '.[] | .pid')

  # 发送SIGTERM信号
  for pid in $client_pids; do
    kill -15 $pid 2>/dev/null
  done

  # 等待进程退出
  for pid in $client_pids; do
    while kill -0 $pid 2>/dev/null; do
      local current_time=$(date +%s)
      local elapsed_time=$((current_time - start_time))

      # 超时检查
      if [ $elapsed_time -ge $TIMEOUT ]; then
        echo "警告：等待进程$pid超时"
        break
      fi
      sleep 0.5
    done
  done
}

技术要点说明

1. 信号选择：使用SIGTERM(15)而不是SIGKILL(9)，允许应用程序处理终止请求
2. 超时机制：10秒的超时时间在用户体验和系统响应速度间取得平衡
3. 进程状态检查：使用kill -0检查进程是否存在，避免忙等待
4. 错误处理：将错误输出重定向到/dev/null，保持脚本整洁

集成到电源管理脚本

将上述函数集成到Hyprland的电源管理脚本中，确保在执行任何终止会话的操作前调用：

if [[ "$1" == "exit" ]]; then
  terminate_clients
  hyprctl dispatch exit
elif [[ "$1" == "reboot" ]]; then
  terminate_clients
  systemctl reboot
elif [[ "$1" == "shutdown" ]]; then
  terminate_clients
  systemctl poweroff
fi

性能优化建议

1. 并行处理：可以考虑使用并行方式发送终止信号，减少总等待时间
2. 关键进程优先：对重要进程（如浏览器）优先处理
3. 动态超时：根据进程数量和类型动态调整超时时间
4. 日志记录：添加详细的日志记录，便于问题排查

实际效果评估

在实际使用中，这一改进带来了以下好处：

1. Google Chrome等应用程序能够正常保存会话状态
2. 减少了应用程序崩溃或数据损坏的风险
3. 系统关机/重启过程更加稳定可靠
4. 用户不再看到"未正常关闭"的警告提示

总结

在Hyprland桌面环境中实现优雅的客户端终止机制是提升用户体验的重要一环。通过合理的信号处理和等待机制，我们可以在保证系统响应速度的同时，确保应用程序能够完成必要的清理工作。这一解决方案不仅适用于mylinuxforwork/dotfiles项目，也可以作为其他Hyprland配置的参考实现。