Kanata键盘映射工具中defchordsv2-experimental功能的已知问题分析

问题概述

在使用Kanata键盘映射工具的最新defchordsv2-experimental功能时，开发者发现了一个影响和弦功能正常工作的关键问题。当用户按下未被定义为有效和弦的按键组合后，会导致后续所有和弦功能失效。

问题现象

具体表现为：

1. 初始状态下，预定义的和弦（如同时按下.和,键）能够正常工作，正确输出"hello"
2. 当用户按下未被定义的和弦组合（如q和w同时按下）后
3. 系统日志会显示"zero chord candidates left"和"0 possible chords remaining"的警告信息
4. 此后，所有预定义的和弦功能都将失效

技术背景

defchordsv2-experimental是Kanata 1.3.0版本引入的实验性功能，旨在提供更灵活的和弦按键定义方式。该功能允许用户定义多个按键同时按下时触发的宏操作，并支持配置最小空闲时间等参数。

问题根源

经过分析，这个问题源于idling优化逻辑中的缺陷。当系统检测到无效和弦输入时，当前的实现错误地将所有后续和弦输入都判定为无效，而不是重置状态等待新的有效输入。

临时解决方案

项目维护者提供了以下临时解决方案，用户可以在配置文件中任意位置添加以下代码：

(defalias unused (switch ((key-timing 1 gt 200)) 0 break))

这段代码利用了Kanata的key-timing功能，通过设置200毫秒的超时阈值，强制系统在一定时间后重置状态。这与Kanata文档中关于key-history和key-timing的警告说明一致，即该配置项的最大毫秒值决定了Kanata变为空闲状态所需的最短时间。

长期修复方向

从技术角度来看，完整的修复方案应该包括：

1. 在idling优化逻辑中添加无效输入检测
2. 确保系统在遇到无效输入后能够正确重置状态
3. 保持对后续有效和弦输入的响应能力

用户建议

对于需要使用defchordsv2-experimental功能的用户，建议：

1. 目前采用上述临时解决方案
2. 关注Kanata项目的更新，等待官方修复此问题
3. 在配置中谨慎定义所有可能的按键组合，或确保不会误触未定义的组合

这个问题特别影响Mac OS用户，但理论上会影响所有平台上的Kanata 1.3.0版本用户。随着项目的持续开发，预期这个问题将在后续版本中得到彻底解决。