Hammerspoon中Canvas鼠标事件在空间切换时失效的解决方案

问题现象

在使用Hammerspoon的Canvas模块时，开发者发现当设置了windowLevels.desktopIcon级别的Canvas元素，在以下情况下会出现鼠标事件失效的问题：

1. 切换工作空间(Spaces)后
2. 点击Canvas区域外的桌面区域后

具体表现为原本正常工作的鼠标点击回调函数不再被触发，即使切换回原来的工作空间也无法恢复。

问题分析

经过深入测试和分析，发现这个问题与Canvas的窗口层级(windowLevel)设置密切相关。当Canvas被设置为desktopIcon级别时，虽然能够保持在桌面图标层显示，但会失去鼠标事件的响应能力。

这种现象的根本原因是macOS的窗口管理系统对低层级窗口的事件处理机制。当Canvas处于desktopIcon级别时：

• 它确实能够显示在所有其他窗口下方
• 但一旦失去"焦点"(如点击桌面或其他操作)，系统会停止向其传递鼠标事件
• 这种状态是不可逆的，即使切换回原来的空间也无法恢复

解决方案

经过多次测试，发现将Canvas的窗口层级设置为略低于普通窗口级别(normal - 1)可以完美解决这个问题：

self.canvas:level(hs.canvas.windowLevels.normal - 1)

这种设置的优势在于：

1. 保持Canvas在所有常规应用窗口下方显示
2. 鼠标事件能够持续响应，不受空间切换或点击外部区域的影响
3. 空间切换时不会出现Canvas突然跳到最前面的闪烁现象

最佳实践建议

1. 避免使用desktopIcon级别：除非确实需要显示在桌面图标层，否则应避免使用desktopIcon级别，因为它会带来鼠标事件丢失的问题。

2. 合理设置窗口层级：根据实际需求选择适当的窗口层级：

   • normal - 1：适合需要持续交互的桌面元素
   • desktopIcon：仅适合纯展示且不需要交互的元素

3. 窗口行为设置：虽然在这个问题中canJoinAllSpaces等行为设置不是根本原因，但合理设置窗口行为仍然重要：

   self.canvas:behavior(hs.canvas.windowBehaviors.canJoinAllSpaces)
   

4. 事件回调处理：确保鼠标回调函数被正确保留，避免被垃圾回收：

   -- 将回调存储在长期存在的变量中
   self.mouseCallback = function(canvas, event, id, x, y)
       -- 处理逻辑
   end
   self.canvas:mouseCallback(self.mouseCallback)
   

总结

Hammerspoon的Canvas模块是一个非常强大的工具，可以创建丰富的桌面交互元素。通过合理设置窗口层级，开发者可以避免鼠标事件丢失的问题，同时保持良好的视觉体验。记住关键点：在需要持续交互的场景下，使用normal - 1级别而非desktopIcon级别，这是保证Canvas元素稳定工作的关键。