Skip to content

[Bug] macOS 下快捷键/托盘偶发无法唤起主窗口(重启可恢复) #559

Description

@mucwj

🐛 Bug 描述

在 macOS 上,ZTools 有时无法通过全局快捷键(如 Alt+Space)或托盘菜单「显示/隐藏」唤起主窗口,按快捷键或点击托盘均无可见反应。

目前已确认的现象:

  • 出现问题时,在全屏应用内较难唤起;退出全屏或在非全屏场景下有时仍正常(尚未稳定复现固定规律)。
  • 完全退出并重启 ZTools 后,问题会消失,全屏和非全屏下均可正常唤起。

说明:该 Issue 记录的是实际遇到的情况。目前尚未找到稳定、可重复的复现步骤,也尚未确认根因。

📋 复现步骤

目前不能稳定复现,以下为出现问题前后的大致操作,仅供参考:

  1. 启动 ZTools,确认快捷键和托盘 initially 可正常唤起
  2. 正常使用一段时间(曾出现问题的进程连续运行约 23 小时,但是否与时长有关尚不确定)
  3. 在前台应用为全屏时(如 Cursor、Ghostty),按 Alt+Space 或点击托盘「显示/隐藏」
  4. 观察主窗口是否出现

恢复方式(已验证有效):

  1. 完全退出 ZTools(托盘 → 退出,或 killall ZTools
  2. 重新打开 ZTools
  3. 再次尝试唤起 → 预期恢复正常

✅ 预期行为

快捷键和托盘操作应稳定唤起 ZTools 主窗口,不应依赖重启才能恢复。

❌ 实际行为

  • 出现问题时:按快捷键或点击托盘,主窗口不出现(或偶发闪一下即消失)
  • 重启 ZTools 后:唤起功能恢复,全屏和非全屏下均可正常使用

📸 截图

无。

💻 环境信息

  • OS: macOS 26.0 (Build 25A354), Apple Silicon (arm64)
  • ZTools 版本: 2.4.1(/Applications/ZTools.app
  • 快捷键: Alt+Space(默认)

📝 错误日志

出现问题期间,~/Library/Application Support/ZTools/logs/main.log 中可见类似记录(含义尚不明确):

[Window] 隐藏窗口 false

启动时快捷键注册日志正常:

快捷键 Alt+Space 注册成功
[Settings] 启动时应用快捷键设置: Alt+Space 成功

🔍 额外信息

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    Status
    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions