Kanata键盘映射工具中Chord v2功能在非基础层失效问题解析

问题背景

在使用Kanata键盘映射工具时，用户发现Chord v2功能在基础层(base layer)可以正常工作，但在切换至其他层(如数字层numpad)时却无法触发预设的和弦动作。这是一个典型的功能层间兼容性问题，值得深入探讨其原理和解决方案。

技术原理分析

Kanata的Chord v2功能设计遵循以下核心原则：

1. 物理键位优先：Chord v2的触发检测是基于键盘的物理键位(input positions)而非逻辑映射层。这意味着无论当前处于哪个逻辑层，和弦触发始终检测的是物理按键的位置。

2. 预处理机制：和弦处理发生在键盘事件处理管道的早期阶段，先于层映射处理。这种设计确保了和弦功能的稳定性和一致性。

3. 层间隔离：每个逻辑层可以视为一个独立的键盘映射空间，但Chord v2的触发机制跨越了这层隔离，始终关注底层物理按键。

问题复现场景

通过简化配置可以清晰复现该现象：

(defcfg
  concurrent-tap-hold yes
  process-unmapped-keys yes
)

(defsrc
  spc d f 
)

(deflayer base
  @spc- _ _
)

(defalias
  spc- (layer-toggle numpad)
)

(deflayer numpad
  _    5 6
) 

(defvar
  chord-time 50
)

(defchordsv2
  (5 6) ' $chord-time first-release ()
)

在此配置中：

• 基础层通过空格键切换至数字层
• 数字层将物理d/f键映射为5/6
• 配置了(5 6)组合触发单引号

问题表现为：在数字层按下物理d/f键(逻辑5/6)时，和弦无法触发。

解决方案

根据Kanata的设计原理，正确的配置方式应该是：

(defchordsv2
  (5 6) ' $chord-time first-release (numpad)
  (d f) ' $chord-time first-release (base)
)

这种配置明确指定了：

1. 当处于numpad层时，检测逻辑5/6组合
2. 当处于base层时，检测物理d/f组合

最佳实践建议

1. 分层定义：为每个需要和弦功能的层单独定义触发组合，明确指定适用的层范围。

2. 物理键意识：始终记住Chord v2是基于物理键位工作的，层映射只影响输出而不影响触发检测。

3. 调试技巧：可以通过定义简单的测试和弦来验证各层的触发条件是否按预期工作。

4. 文档参考：虽然本文不提供链接，但建议用户详细阅读Kanata官方文档中关于Chord v2和层系统的相关章节。

总结

Kanata的Chord v2功能在非基础层失效的问题，本质上是对功能设计原理的理解偏差所致。通过正确理解物理键位优先原则，并采用分层定义的配置方式，可以完美解决这一问题。这种设计虽然增加了初期配置的复杂度，但提供了更稳定可靠的和弦触发机制，值得用户在配置时特别注意。