Screenity绘图模式ESC键关闭功能失效问题解析

在屏幕录制与注释工具Screenity的使用过程中，部分用户反馈绘图模式下按ESC键无法正常退出，仅能关闭操作提示气泡。本文将从技术角度剖析该问题的成因及解决方案。

问题现象重现

当用户启用Screenity的绘图功能时，界面会显示操作提示气泡（包含"按ESC键退出"的说明）。实际测试发现：

1. 按下ESC键仅关闭提示气泡，绘图模式仍保持激活状态
2. 点击提示气泡反而能正确退出绘图模式
3. 该问题在Chrome浏览器（v120）及手动安装的Screenity v3.1.1版本中稳定复现

技术根源分析

经项目维护者确认，问题源于事件处理机制的设计缺陷：

• 使用了不兼容的Radix UI Toast组件事件处理器
• ESC键事件未被正确捕获并路由到绘图模式的关闭逻辑
• 点击事件的处理管道独立于键盘事件，故能正常工作

解决方案实现

开发团队通过以下改进修复该问题：

1. 替换为Radix UI Toast组件的标准事件处理器
2. 确保键盘事件能正确触发绘图模式关闭回调
3. 保持与现有UI组件的兼容性

该修复已随Screenity v3.1.2版本发布，用户更新后即可获得完整的键盘操作支持。对于浏览器扩展商店审核延迟的情况，建议用户关注项目GitHub页面的Release动态。

用户操作建议

1. 检查浏览器扩展版本是否为v3.1.2或更高
2. 在绘图模式下可通过两种方式退出：
   • 直接按ESC键（推荐）
   • 点击操作提示气泡
3. 如遇异常，可尝试重启浏览器或重新加载扩展

此案例典型展示了前端组件库在事件处理机制上的兼容性考量，提醒开发者在集成第三方UI组件时需特别注意事件管道的完整性验证。