Input-Leap项目中光标消失与输入失效问题的分析与解决

问题背景

Input-Leap（原Barrier项目）是一款开源的键盘鼠标共享工具，允许用户在多台计算机间共享同一套输入设备。近期在Wayland环境下使用Input-Leap时，用户报告了一个严重问题：当尝试将光标从服务器屏幕移动到客户端屏幕时，光标会突然消失，所有输入设备失效，且无法恢复，必须通过SSH远程终止Input-Leap服务才能重新获得控制权。

问题现象

该问题首次出现在特定提交后，主要表现为：

1. 在GNOME Linux服务器（使用libei）与Windows 10客户端之间建立连接
2. 当光标试图移动到客户端屏幕时立即消失
3. 所有输入设备（键盘、鼠标）完全失去响应
4. 只能通过远程终止服务恢复控制

技术分析

从调试日志中可以观察到几个关键点：

1. EIS连接异常：日志显示"Invalid event from receiver ei context"错误，表明与输入仿真服务(EIS)的连接出现问题。

2. 设备状态异常：设备状态在短时间内经历了多次转换（NEW→PAUSED→RESUMED→EMULATING→DEAD），表明设备管理流程存在缺陷。

3. 输入捕获失效：在PortalInputCapture激活后，系统未能正确处理输入设备的控制权转移。

4. 屏障应用失败：日志中出现"Failed to apply barrier"警告，表明屏幕边缘的屏障检测机制未能正确工作。

根本原因

经过开发者分析，问题源于以下技术因素：

1. 输入捕获与释放的时序问题：在Wayland环境下，Input-Leap未能正确处理输入设备控制权的交接流程。

2. 设备状态机缺陷：设备状态转换逻辑存在问题，导致设备异常进入DEAD状态后无法恢复。

3. 屏障同步失败：屏幕边缘的虚拟屏障未能正确同步，导致光标移动检测失效。

解决方案

开发团队通过多个补丁提交解决了这一问题：

1. 改进设备状态管理：修复了设备状态机的转换逻辑，确保设备在异常情况下能够正确恢复。

2. 增强输入捕获可靠性：优化了PortalInputCapture的实现，确保输入设备控制权的平稳交接。

3. 完善屏障同步机制：改进了屏幕边缘屏障的检测和同步逻辑。

4. 增加错误恢复机制：在检测到异常状态时，能够自动尝试恢复而不是完全锁定输入。

验证结果

用户验证表明，应用这些补丁后：

• 光标能够正常在服务器和客户端屏幕间移动
• 输入设备不再出现完全锁死的情况
• 系统稳定性显著提高

技术启示

这一问题的解决过程为Wayland环境下的输入共享工具开发提供了宝贵经验：

1. 状态机设计：复杂的设备状态转换需要严谨的设计和充分的边界条件测试。

2. 错误恢复：在输入控制类应用中，必须设计完善的错误恢复机制，避免完全失去控制。

3. 协议兼容性：跨协议（X11/Wayland）的输入处理需要特别注意不同环境下的行为差异。

4. 日志分析：详细的调试日志对于定位复杂交互问题至关重要。

该问题的解决不仅修复了当前版本的问题，也为Input-Leap在Wayland环境下的长期稳定发展奠定了基础。