解决lan-mouse项目在KDE Plasma下鼠标冻结问题

问题背景

lan-mouse是一个实现跨系统鼠标键盘共享的开源工具。近期有用户反馈，在Fedora 40 KDE Plasma 6.1.1(Wayland)和Windows 11(26120.961)环境下使用时，从Linux切换回Windows后会出现鼠标和输入设备冻结的问题，只能强制关机解决。

技术分析

从日志信息可以看出，问题主要出现在输入捕获和模拟环节：

1. Windows端日志显示正常启动了捕获服务，使用了Windows原生后端
2. Linux端日志显示尝试了多种输入模拟后端：
   • 首先尝试wlroots后端失败(因缺少wlr-virtual-pointer-unstable-v1协议支持)
   • 然后回退到libei后端
   • 最后使用了input-capture-portal作为捕获后端

解决方案

经过项目维护者确认，这是一个已知的兼容性问题。在KDE Plasma环境下，需要显式配置使用LayerShell作为捕获后端。

具体解决方法是在lan-mouse的配置文件中添加：

capture_backend = "LayerShell"

技术原理

1. LayerShell协议：是Wayland下用于管理窗口层级和特殊用途表面的协议，适合实现跨窗口的输入捕获
2. Wayland兼容性：不同桌面环境对Wayland协议的支持程度不同，KDE Plasma需要特定的捕获方式
3. 输入模拟后端：libei作为通用输入模拟接口，在wlroots不可用时提供了回退方案

最佳实践

对于使用KDE Plasma的用户，建议：

1. 始终在配置中明确指定捕获后端
2. 保持系统和lan-mouse工具的最新版本
3. 遇到问题时检查日志文件中的后端选择信息

此解决方案已得到用户验证，能够有效解决鼠标冻结问题。对于其他桌面环境用户，如果遇到类似问题，也可以尝试指定不同的捕获后端来测试兼容性。