KeyboardShortcuts项目在macOS 15中的Option键快捷键问题解析

问题背景

KeyboardShortcuts是一个用于处理全局键盘快捷键的Swift库。在macOS 15.0 Beta版本中，开发者发现一个严重问题：仅使用Option键（或Option+Shift组合）的全局快捷键无法正常工作。这个问题影响了多个依赖该库的应用程序，特别是那些通过Mac App Store分发的沙盒应用。

技术分析

根本原因

macOS 15.0（代号Sequoia）引入了一项安全变更，目的是防止键盘记录恶意软件捕获用户在其他应用程序中输入的特殊字符（如通过Shift+Option组合输入的Ø等字符）。这项变更导致RegisterEventHotKeyAPI对于仅包含Option或Option+Shift的快捷键注册会返回错误代码-9868（hotKeyAlreadyExistsErr）。

影响范围

1. 沙盒应用：受影响最严重，完全无法注册这类快捷键
2. 非沙盒应用：在安全输入模式激活时也会受到限制
3. API限制：标准API无法绕过此限制，即使添加辅助功能权限也无济于事

解决方案演进

临时解决方案

在等待苹果修复期间，开发者建议用户：

1. 改用Control键替代Option键作为修饰键
2. 对于必须使用Option键的场景，考虑使用非沙盒分发方式

官方修复

苹果在macOS 15.2 Beta中修复了此问题：

1. 恢复了Option键快捷键的正常功能
2. 移除了相关的权限警告对话框
3. 该修复已通过KeyboardShortcuts 2.2.4版本验证

技术启示

1. 系统API的脆弱性：底层系统API的变更可能对上层应用产生深远影响
2. 沙盒限制：苹果对沙盒应用施加了更严格的安全限制
3. 安全与功能的平衡：安全增强有时会以牺牲用户体验为代价
4. beta测试的重要性：早期参与系统beta测试有助于提前发现问题

最佳实践建议

1. 对于关键快捷键功能，考虑提供多种修饰键选项
2. 在应用启动时检查快捷键注册状态，提供友好的错误提示
3. 保持对系统更新和API变更的关注
4. 对于时间敏感的功能，考虑备用实现方案（如NSEvent监控）

这个案例展示了macOS生态系统中安全策略与开发者需求之间的张力，也提醒开发者需要为系统级变更做好准备。