Solaar项目：解决MX Master 3鼠标手势规则失效问题

问题背景

在Ubuntu 24.04系统上使用Solaar 1.1.13版本配置Logitech MX Master 3鼠标时，用户发现无法为手势按钮创建有效规则。尽管按照官方文档配置了规则文件，手势按钮始终默认触发"Super+Tab"组合键功能。

核心问题分析

经过技术排查，发现问题的根本原因在于用户未正确设置按键分流(Divert)选项。Solaar的鼠标手势功能需要明确将特定按钮分流到手势识别通道，否则系统会继续处理默认按键行为。

技术解决方案

要启用MX Master 3鼠标的手势功能，必须完成以下两个关键步骤：

1. 按键分流设置： 在Solaar界面中找到"Key/Button Diversion"选项 将"Mouse Gesture Button"的状态从"Regular"改为"Diverted" 这个设置会使按钮事件发送HID++通知而非标准按键信号

2. 规则文件配置： 确保规则文件(~/.config/solaar/rules.yaml)包含正确的手势映射 示例配置如下：

   - MouseGesture: Mouse Gesture Button
   - KeyPress:
     - Super_L
     - click
   

实现原理

当按钮被设置为"Diverted"模式时：

• 鼠标不再发送标准按键事件
• 改为发送HID++协议的特殊通知
• Solaar可以拦截这些通知并应用自定义规则
• 系统不再处理默认的"Super+Tab"行为

注意事项

1. Wayland环境下需要GNOME扩展支持才能完全访问修饰键
2. 规则文件采用YAML 1.3格式，注意缩进和语法
3. 修改配置后建议重启Solaar服务确保变更生效

总结

通过正确配置按键分流选项，用户可以完全控制MX Master 3鼠标的手势功能。这一解决方案不仅适用于Ubuntu 24.04，也适用于其他基于Wayland的Linux发行版。理解HID++协议和按键分流机制是充分发挥Logitech设备高级功能的关键。