Input Remapper 处理 Wacom 设备按键映射时的异常问题分析

问题现象

在使用 Input Remapper 为 Wacom 数位板配置按键映射时，用户遇到了两个主要问题：

1. 当尝试映射数位板上的 Express Keys 时，软件似乎无法正确识别这些按键输入
2. 在尝试后，预设配置会进入"锁定"状态 - 无法编辑也无法删除，只能通过手动删除配置文件来恢复

技术分析

根本原因

问题的核心在于 Python evdev 库的最新变更。在较新版本中，evdev.ecodes.bytype 返回的按键名称从字符串变为了元组(tuple)。例如，对于 BTN_0 按键：

旧版本返回："BTN_0"
新版本返回：('BTN_0', 'BTN_MISC')

Input Remapper 的代码中假设按键名称始终是字符串，并直接调用了字符串的 replace() 方法，这在遇到元组时就会抛出 AttributeError 异常。

错误堆栈分析

从错误日志可以看到，问题发生在以下调用链中：

1. 尝试格式化映射名称时调用 mapping.format_name()
2. 进而调用 input_combination.beautify()
3. 最终在 _get_name() 方法中尝试对元组调用 replace() 方法

影响范围

此问题主要影响：

• 使用 Wacom 等专业输入设备的用户
• 设备上具有特殊按键（如 Express Keys）的情况
• 使用较新版本 evdev 库的环境

临时解决方案

对于遇到此问题的用户，可以采取以下步骤：

1. 手动删除损坏的预设文件：

   rm ~/.config/input-remapper-2/presets/Wacom\ Intuos4\ 8x13\ Pad/Krita.json
   

2. 重启 Input Remapper 应用
3. 避免尝试映射当前会导致问题的按键，等待官方修复

开发者建议

从技术实现角度，建议进行以下改进：

1. 增强类型检查：在处理按键名称前，应先检查其类型
2. 元组处理逻辑：当遇到元组类型的按键名称时，应选择第一个元素作为主名称
3. 错误恢复机制：当预设加载失败时，应提供自动恢复或重置选项
4. 预设管理界面：增加直接从界面删除预设的功能，避免需要手动操作文件系统

总结

这个问题展示了外部依赖变更可能对应用程序稳定性的影响。Input Remapper 需要更新其按键名称处理逻辑以适应 evdev 库的新行为。对于用户而言，目前可以通过手动删除配置文件来恢复功能，但期待开发者能尽快发布包含修复的版本。