Kitty终端中处理带空格用户变量的条件映射问题

问题背景

在使用Kitty终端模拟器时，开发者经常需要根据当前窗口的用户变量(user variables)来设置条件快捷键映射。然而，当这些变量值包含空格或其他特殊字符时，条件匹配可能会失效。

问题重现

在Kitty终端中，当尝试为包含空格的用户变量值设置条件映射时，例如变量cmdline的值为"adb shell"，直接使用以下命令会失败：

kitty --config NONE -o 'map --when-focus-on var:cmdline="adb shell" f1 send_text all WORKS'

这种情况下，按下F1键不会触发预期的文本发送操作。

根本原因

Kitty的条件匹配语法解析器对包含空格或特殊字符的变量值处理存在限制。当变量值包含空格时，解析器会将空格后的内容误认为是新的条件参数，而不是变量值的一部分。

解决方案

Kitty开发者提供了正确的语法格式来解决这个问题：

1. 使用引号包裹整个变量匹配表达式：

   map --when-focus-on 'var:"cmdline=adb shell"' ctrl+l combine : clear_terminal scrollback active : send_key ctrl+[ : send_key ctrl+l
   

2. 在命令行参数中的正确转义方式：

   kitty --config NONE -o "map --when-focus-on 'var:\"cmdline=adb shell\"' f1 send_text all WORKS"
   

技术细节

Kitty的条件匹配语法要求：

• 当变量值包含空格时，必须使用引号将整个var:"name=value"表达式包裹起来
• 在命令行参数中传递时，需要特别注意引号的嵌套和转义
• 内部引号需要使用反斜杠转义，而外部引号则根据shell的规则处理

实际应用示例

假设我们需要为不同的adb命令设置不同的快捷键：

1. 当cmdline为"adb devices"时，F1键列出设备
2. 当cmdline为"adb shell"时，F1键进入交互模式

正确的配置方式为：

# 对于adb devices
map --when-focus-on 'var:"cmdline=adb devices"' f1 send_text all adb devices\n

# 对于adb shell
map --when-focus-on 'var:"cmdline=adb shell"' f1 send_text all adb shell\n

总结

Kitty终端在处理带空格用户变量的条件映射时，需要特别注意引号的使用和转义规则。通过正确使用引号包裹整个变量匹配表达式，可以确保条件映射在各种复杂情况下都能正常工作。这一技巧对于开发需要根据不同命令行环境动态调整快捷键的高级用户特别有用。