Kanata项目中的宏命令字符丢失问题分析

问题背景

在Kanata键盘映射工具中，用户报告了一个关于宏命令(macro)在特定条件下字符丢失的问题。具体表现为当宏命令包含多个字符时，在组合键(chord)中使用时第二个字符会消失。

问题复现

通过分析用户提供的配置文件，我们可以清晰地复现这个问题。配置中定义了一个基础层(base layer)和三个按键(a、b、o)的映射关系。其中按键a被映射为一个包含两个字符(a和z)的宏命令。

当单独按下a键时，理论上应该依次输出a和z两个字符。然而在实际测试中，只有第一个字符a被输出，第二个字符z丢失了。这个问题在Kanata的在线模拟器中也能稳定复现，排除了本地环境因素。

技术分析

深入分析这个问题，我们发现根本原因在于Kanata处理同时运行的宏命令时的机制。当宏命令在组合键环境中执行时，系统会尝试同时处理多个宏命令的输出，导致后续字符被覆盖或丢失。

特别值得注意的是，当两个宏命令尝试输出同一个字符时(比如都包含z)，系统无法正确处理这种冲突情况。这也是为什么即使用multi指令作为临时解决方案，也无法完全满足用户需求的原因。

解决方案与替代方案

虽然目前Kanata的架构无法完美支持用户期望的"按键序列"输出模式(如按顺序输出a、z、z)，但开发者提供了几种替代方案：

1. 使用multi指令替代macro，这可以解决部分场景下的问题，但不支持重复按键输出
2. 添加人工延迟，虽然不够优雅但可以作为临时解决方案
3. 重新设计按键映射逻辑，避免依赖宏命令的序列输出特性

项目现状与展望

这个问题揭示了Kanata在处理复杂宏命令和组合键时的局限性。虽然开发者已经定位到了问题原因，但由于架构设计上的考虑，短期内可能不会支持完全的按键序列输出功能。

对于需要精确控制按键序列的高级用户，可能需要考虑其他键盘映射工具，或者等待Kanata未来版本对此功能的增强支持。同时，这也提醒我们在设计键盘映射方案时，需要充分了解工具的特性和限制，选择最适合的实现方式。