Scroll窗口管理器中的鼠标焦点切换问题分析与解决方案

Scroll窗口管理器中的鼠标焦点切换问题分析与解决方案

scroll i3-compatible Wayland compositor (sway) with a PaperWM layout 项目地址: https://gitcode.com/gh_mirrors/scroll13/scroll

问题现象描述

在使用Scroll窗口管理器(基于Sway的分支版本)时，用户遇到了一个特殊的窗口焦点切换问题。具体表现为：当用户在Thunderbird邮件客户端中点击"回复"按钮打开全屏回复窗口后，偶尔(约10%的概率)在将鼠标移动到屏幕左上角区域时，窗口会自动切换回主Thunderbird界面，而非停留在回复窗口。

技术背景分析

Scroll窗口管理器继承自Sway，采用Wayland协议，其窗口焦点管理机制遵循以下原则：

1. 焦点跟随鼠标：默认情况下，当鼠标悬停在某个窗口表面时，窗口管理器会自动将焦点切换到该窗口
2. 边缘间隙处理：为避免意外聚焦，当鼠标位于窗口外边缘间隙(gaps outer)范围内时，需要点击才能切换焦点
3. 窗口可见性保证：当焦点切换到新窗口时，窗口管理器会确保该窗口完全可见

问题根源探究

经过深入分析，发现问题源于以下几个技术细节的交互：

1. 间隙设置过小：用户配置中gaps inner为1像素，gaps outer为2像素，导致窗口间距极小
2. 边缘检测逻辑：当鼠标恰好位于边缘间隙范围内时，焦点切换行为变得不稳定
3. 场景图节点与容器尺寸不匹配：底层实现中存在尺寸计算不一致的问题

解决方案实现

开发者通过以下方式解决了该问题：

1. 修正尺寸计算：修复了场景图节点与容器尺寸不匹配的问题(提交1c1627f)
2. 配置建议：
   • 将gaps outer设为0，完全消除边缘间隙
   • 或保持gaps outer为2，但确保gaps inner足够大

配置最佳实践

基于此案例，建议用户在Scroll窗口管理器中采用以下配置策略：

1. 焦点行为：

   • focus_follows_mouse yes：适合习惯鼠标操作的用户
   • focus_follows_mouse no：适合纯键盘操作场景

2. 间隙设置：

   • 全屏应用场景：gaps inner 1配合gaps outer 0
   • 多窗口工作场景：适当增大gaps inner值(建议≥5)

3. 配置重载注意：

   • 间隙设置更改仅对新工作区生效
   • 边框大小更改仅对新窗口生效

技术启示

此案例揭示了窗口管理器设计中几个关键考量点：

1. 边缘检测算法的精确性：需要平衡灵敏度和防误触
2. 场景图一致性：底层数据结构必须保持同步
3. 用户配置适应性：设计应能适应各种极端配置情况

通过这次问题修复，Scroll窗口管理器在边缘焦点切换场景下的表现更加稳定可靠，为用户提供了更流畅的操作体验。

scroll i3-compatible Wayland compositor (sway) with a PaperWM layout 项目地址: https://gitcode.com/gh_mirrors/scroll13/scroll