Kanata项目中的鼠标设备自动发现与配置优化

背景介绍

Kanata是一个键盘映射工具，它允许用户自定义键盘输入行为。在Linux系统中，Kanata通过自动发现输入设备来实现键盘重映射功能。然而，当前版本在处理鼠标设备时存在一些问题，特别是当用户并不需要重映射鼠标按键时，Kanata仍然会捕获鼠标输入，这可能导致鼠标灵敏度设置失效或其他兼容性问题。

问题分析

在Linux环境下，Kanata默认会捕获所有输入设备，包括鼠标。这会导致以下问题：

1. 当用户已经在窗口管理器(如Hyprland)中配置了鼠标灵敏度时，Kanata的捕获会覆盖这些设置
2. 系统中有多个鼠标设备时，设备识别可能不稳定
3. 对于不需要鼠标重映射功能的用户来说，这种默认行为增加了不必要的复杂性

技术解决方案

Kanata开发团队提出了几种改进方案：

1. 基于defsrc的智能忽略：通过分析defsrc配置中是否包含鼠标按键，自动决定是否捕获鼠标设备
2. 显式配置选项：新增linux-device-detect-mode配置项，允许用户明确指定只捕获键盘设备
3. 向后兼容性考虑：保持现有行为作为默认选项，同时提供禁用鼠标捕获的配置方式

实现细节

在技术实现上，主要修改了设备检测逻辑：

1. 新增设备检测模式枚举，包括All(默认)、KeyboardOnly和Explicit三种模式
2. 在设备检测阶段，根据配置模式过滤掉鼠标设备
3. 添加详细的调试日志，帮助用户理解设备捕获决策过程

用户配置建议

对于不需要鼠标重映射功能的用户，推荐在配置文件中添加：

linux-device-detect-mode keyboard-only

对于需要精细控制的用户，可以使用排除列表：

linux-dev-names-exclude (
    "Logitech USB Receiver"
    "Other Mouse Device Name"
)

未来展望

这一改进为Kanata的设备管理带来了更大的灵活性。未来可能会考虑：

1. 更细粒度的设备类型过滤
2. 基于设备能力的自动检测
3. 动态设备管理，支持热插拔场景下的配置更新

总结

Kanata对鼠标设备处理方式的优化，体现了项目对用户体验的持续关注。通过提供更灵活的配置选项，既满足了不需要鼠标重映射用户的需求，又保持了现有功能的向后兼容性。这一改进使得Kanata在各种使用场景下都能提供更稳定、更符合预期的行为。