Solaar项目：解决Logitech MX Master 2S鼠标手势按钮双击检测问题

在Linux环境下使用Logitech MX Master 2S鼠标时，用户可能会遇到一个常见问题：当通过Solaar工具配置鼠标手势按钮（Mouse Gesture Button）来触发系统功能（如打开应用概览视图）时，系统会快速打开又立即关闭该视图。这种现象通常是由于按钮的按下(pressed)和释放(released)事件都被检测到，导致系统误判为连续两次点击。

问题分析

MX Master 2S鼠标的拇指按钮（官方称为Mouse Gesture Button）在默认配置下主要用于手势操作。当用户尝试通过Solaar的规则编辑器将其重新映射为系统快捷键（如Super_L+a组合键）时，如果规则简单地监听按钮的"按下"事件，会导致以下问题：

1. 按钮按下时触发第一次动作
2. 按钮释放时可能被误认为第二次触发
3. 系统接收到两个快速连续的相同命令，导致功能状态切换（如打开后又立即关闭应用概览）

解决方案

经过技术验证，正确的配置方法应该是监听按钮的"释放"事件而非"按下"事件，并结合鼠标手势条件进行过滤。以下是优化后的规则配置：

---
- And:
  - Key: [Mouse Gesture Button, released]
  - MouseGesture: []
- KeyPress:
  - Super_L
  - click
...

这个配置的关键改进点包括：

1. 使用released而非pressed事件，避免按钮状态变化导致的多次触发
2. 添加MouseGesture: []条件，确保只有在纯按钮释放时触发，排除实际手势操作的情况
3. 简化按键组合为单独的Super_L键，提高可靠性

技术原理

这种解决方案有效的根本原因在于：

1. 按钮释放事件比按下事件更适合作为触发条件，因为它代表一个完整的操作周期
2. 鼠标手势检测条件可以排除误触发，确保只在明确需要的时候执行操作
3. 单键触发比组合键更稳定，减少了系统处理多个按键事件的复杂度

配置建议

对于Ubuntu 24.04 LTS及其他GNOME桌面环境的用户，建议：

1. 确保Solaar版本为1.1.13或更新
2. 检查鼠标固件是否为最新版本
3. 在规则配置后，通过系统日志监控实际触发的事件
4. 对于不同桌面环境，可能需要调整具体的快捷键组合

通过这种配置方式，用户可以稳定地使用MX Master 2S鼠标的拇指按钮来触发系统功能，而不会出现意外的双击效果。这大大提升了鼠标自定义功能的实用性和用户体验。