Kanata键盘映射工具在Windows下的箭头键与六键区问题解析

问题现象

在使用Kanata键盘映射工具时，用户发现当尝试重新映射方向键(上下左右)以及PageUp、PageDown等六键区按键时，工具实际输出的是数字小键盘的按键。例如，向下箭头键被映射为数字小键盘的2键。这一现象在使用NVDA屏幕阅读器的Windows 11系统上被发现。

技术背景

Kanata是一款强大的键盘映射工具，允许用户自定义键盘布局和按键功能。在Windows系统下，Kanata通过底层钩子(LLHook)机制来拦截和处理键盘输入事件。这种机制需要正确处理扫描码(Scancode)和虚拟键码(Virtual Key Code)之间的转换关系。

问题根源

经过分析，这一问题源于Windows系统对于某些特殊按键的处理方式。方向键和六键区按键在Windows中有两种表示形式：

1. 扩展扫描码(Extended Scancode)
2. 非扩展扫描码(Non-extended Scancode)

当Kanata使用虚拟键码而非扫描码作为输出时，Windows系统可能会错误地将这些特殊按键识别为数字小键盘的按键。这与NVDA屏幕阅读器无关，而是Windows系统本身在处理这些特殊按键时的固有行为。

解决方案

目前Kanata提供了三种不同的Windows实现变体：

1. 默认实现(LLHook)：使用底层钩子机制，但存在上述问题
2. WinIOv2变体：通过WinIO驱动实现，可以正确识别特殊按键
3. Scancode_experimental变体：使用扫描码直接输出，避免了虚拟键码转换问题

测试表明，后两种变体都能正确解决箭头键和六键区按键的映射问题。

未来改进

从Kanata 1.7.0版本开始，Windows平台的默认二进制文件将改为使用扫描码输出方式，这将从根本上解决此类问题。这一改变意味着：

• 更准确的按键识别
• 更好的系统兼容性
• 更可靠的按键映射行为

总结

键盘映射工具在Windows平台上的实现需要考虑系统底层对特殊按键的处理机制。Kanata团队已经识别出这一问题，并通过提供替代实现方案和计划中的默认行为变更来解决。对于当前遇到此问题的用户，建议使用WinIOv2或Scancode_experimental变体作为临时解决方案，等待1.7.0版本的正式发布。