Kando菜单项目在macOS上的多桌面切换问题分析与解决方案

Kando是一款优秀的快捷菜单工具，但在macOS平台上存在一个特殊的多桌面切换问题。本文将深入分析该问题的成因，并详细介绍开发团队找到的最终解决方案。

问题现象

在macOS系统上使用Kando时，当用户执行以下操作序列时会出现异常行为：

1. 打开两个Firefox窗口
2. 将其中一个窗口全屏并聚焦
3. 关闭全屏窗口
4. 切换到不同桌面
5. 调用Kando菜单(Control+Space)
6. Kando菜单会在错误的屏幕上显示

问题根源分析

经过开发团队深入研究，发现这个问题本质上是Electron框架与macOS虚拟工作空间管理机制之间的兼容性问题。具体表现为：

1. Electron的窗口类型设置为"panel"时，与macOS的空间管理存在冲突
2. 当应用程序在全屏状态和普通状态间切换时，窗口的空间归属信息会丢失
3. macOS对跨空间窗口的处理机制不够完善

解决方案探索

开发团队尝试了多种解决方案，最终确定了一套完整的修复方案：

核心修改点

1. 窗口类型调整：将Kando窗口类型从"panel"改为"normal"，这为后续的空间管理提供了基础
2. 空间同步机制：使用setVisibleOnAllWorkspacesAPI确保窗口能正确跟随当前空间
3. 激活策略优化：设置activationPolicy为'accessory'来隐藏Dock图标

关键代码实现

// 修改窗口类型为normal
this.window.setAlwaysOnTop(true, 'screen-saver');
app.setActivationPolicy('accessory')

// 空间同步逻辑
this.window.setVisibleOnAllWorkspaces(true, { skipTransformProcessType: true });
setTimeout(() => {
  this.window.setVisibleOnAllWorkspaces(false, { skipTransformProcessType: true });
}, 100);

方案优势

1. 完美解决空间切换问题：Kando菜单现在能稳定地在当前空间显示
2. 保持原生体验：不会出现在Dock或Cmd+Tab应用切换器中
3. 焦点管理正确：使用后能正确返回到之前的窗口
4. 性能影响小：增加的延迟几乎不可感知

实现细节说明

1. skipTransformProcessType参数确保了窗口空间切换时不会影响进程类型
2. 100ms的延迟为系统提供了足够的处理时间窗口
3. 'screen-saver'级别的置顶保证了Kando能覆盖全屏应用
4. 'accessory'激活策略既隐藏了Dock图标，又保持了功能完整

结论

通过这次问题修复，Kando在macOS平台上的多桌面体验得到了显著提升。这个案例也展示了Electron应用在macOS平台上需要注意的特殊行为，特别是与空间管理和窗口类型相关的细节。开发团队通过深入分析系统机制，找到了既解决问题又保持良好用户体验的平衡方案。