Omarchy 插件卸载后所有快捷键失效的排查
内容提要
试用 Omarchy Workspace Manager 插件后卸载，导致 Alt+Tab、Super+Tab 等快捷键全部失效。排查发现 Hyprland 的 submap 仍停留在插件的捕获模式，重启 Shell 无效。执行 hyprctl dispatch 'hl.dsp.submap("reset")' 恢复 default 后恢复正常。原因是插件卸载时未退出自定义 submap，清理不完整。
延伸解读
问题根源：Hyprland submap 状态残留
Hyprland 的 submap 允许临时切换整套快捷键映射。Omarchy Workspace Manager 插件在捕获用户输入时进入自定义 submap，但卸载时未退出，导致 Hyprland 停留在该模式。此时键盘事件不再发送给默认映射，因此所有快捷键和插件都看似失效。重启 Omarchy Shell 无效，因为 submap 状态属于 Hyprland，而非 Quickshell。
排查思路：从绑定到 submap 的递进检查
作者依次检查了 Hyprland 快捷键绑定、插件全局快捷键和当前 submap。前两者均正常，说明问题不在绑定或插件本身。最终通过 hyprctl submap 发现输出为 omarchy-workspace-manager-capture，确认是 submap 残留。这种由外到内、从表象到状态的排查顺序，有助于快速定位类似问题。
恢复方法：重置 submap 即可
执行 hyprctl dispatch 'hl.dsp.submap("reset")' 可将 submap 恢复为 default，所有快捷键和插件立即恢复正常。该命令直接重置 Hyprland 的 submap 状态，无需重启 Shell 或重新加载插件。遇到类似快捷键全部失效的情况，可优先检查 submap 状态并尝试重置。
插件开发启示：卸载时需清理 submap
使用自定义 submap 的插件，在关闭界面、禁用或卸载时，应检查自己是否仍拥有当前 submap，并主动恢复默认按键映射。否则一个看似不起眼的状态残留，就会导致整个桌面的快捷键失效。这提醒插件开发者重视卸载清理的完整性，避免影响用户其他操作。
Q&A
卸载 Omarchy Workspace Manager 插件后，为什么所有快捷键都失效了？
因为插件卸载时没有退出它自定义的 submap，导致 Hyprland 一直停留在快捷键捕获模式，键盘事件不再发送给默认按键映射，所以所有快捷键看起来都失效了。
如何检查 Hyprland 当前是否处于异常的 submap 状态？
在终端执行 hyprctl submap 命令，如果输出不是 default，而是类似 omarchy-workspace-manager-capture 的名称，就说明 submap 状态异常。
用什么命令可以退出残留的快捷键捕获模式并恢复默认快捷键？
执行 hyprctl dispatch 'hl.dsp.submap("reset")'，然后再次用 hyprctl submap 确认输出恢复为 default，快捷键即可恢复正常。
重启 Omarchy Shell 为什么不能解决快捷键失效的问题？
因为 submap 状态属于 Hyprland，不属于 Quickshell，重启 Omarchy Shell 不会改变 Hyprland 的 submap 状态，所以问题依旧。
Hyprland 的 submap 是什么？它有什么作用？
Hyprland 的 submap 类似 Emacs 的按键映射，可以临时切换到一套完全不同的快捷键。Workspace Manager 插件利用它来捕获用户输入的快捷键。
如何避免使用自定义 submap 的插件在卸载后导致快捷键失效？
插件在关闭界面、禁用和卸载时，应检查自己是否仍然拥有当前 submap，并主动恢复默认按键映射，确保清理完整。
