Espanso输入法括号扩展问题分析与解决方案

问题现象

在使用Espanso文本扩展工具时，用户发现当替换文本中包含圆括号时，闭合括号")"会出现丢失现象。具体表现为：

1. 直接替换文本如"hello (from) parentheses"会变成"hello (from parentheses"
2. 包含变量替换的复杂表达式也会出现闭合括号丢失

技术背景

Espanso作为文本扩展工具，支持多种文本注入机制：

1. 键盘模拟(keys/inject)：模拟键盘输入每个字符
2. 剪贴板(clipboard)：通过系统剪贴板传递完整文本
3. 自动模式(auto)：根据文本长度自动选择机制

问题根源分析

经过测试发现，该问题与注入机制的选择密切相关：

1. 在剪贴板模式下，所有括号都能正确保留
2. 在键盘模拟模式下：
   • 在VS Code等智能编辑器中，编辑器自动补全会导致括号位置错乱
   • 在终端环境中，闭合括号会完全丢失
3. 默认的自动模式会优先使用键盘模拟机制

解决方案

临时解决方案

1. 强制使用剪贴板模式：

force_mode: clipboard

2. 为特定应用配置专用设置：

app:
  vscode:
    backend: clipboard

长期建议

1. 全局配置调整：

backend: clipboard  # 全局使用剪贴板模式

2. 为特殊应用保留键盘模拟：

app:
  terminal_app:
    backend: auto
    inject_delay: 100  # 适当增加延迟

配置命名规范建议

当前版本存在配置项命名不一致问题：

• 全局配置使用backend: inject
• 匹配配置使用force_mode: keys

建议统一命名规范，如：

• 全局：backend
• 匹配：force_backend

最佳实践

1. 对于包含特殊符号(括号、引号等)的替换文本，优先使用剪贴板模式
2. 为智能编辑器(如VS Code)创建应用专用配置
3. 在终端环境中可尝试增加注入延迟参数

技术展望

未来版本可考虑以下改进：

1. 自动检测特殊符号，智能选择注入机制
2. 统一配置项命名规范
3. 增强键盘模拟模式对特殊符号的处理能力

通过合理配置注入机制，可以有效解决Espanso中的括号扩展问题，确保文本替换的准确性。