🐛 Bug 描述
在 macOS 上,ZTools 有时无法通过全局快捷键(如 Alt+Space)或托盘菜单「显示/隐藏」唤起主窗口,按快捷键或点击托盘均无可见反应。
目前已确认的现象:
- 出现问题时,在全屏应用内较难唤起;退出全屏或在非全屏场景下有时仍正常(尚未稳定复现固定规律)。
- 完全退出并重启 ZTools 后,问题会消失,全屏和非全屏下均可正常唤起。
说明:该 Issue 记录的是实际遇到的情况。目前尚未找到稳定、可重复的复现步骤,也尚未确认根因。
📋 复现步骤
目前不能稳定复现,以下为出现问题前后的大致操作,仅供参考:
- 启动 ZTools,确认快捷键和托盘 initially 可正常唤起
- 正常使用一段时间(曾出现问题的进程连续运行约 23 小时,但是否与时长有关尚不确定)
- 在前台应用为全屏时(如 Cursor、Ghostty),按
Alt+Space 或点击托盘「显示/隐藏」
- 观察主窗口是否出现
恢复方式(已验证有效):
- 完全退出 ZTools(托盘 → 退出,或
killall ZTools)
- 重新打开 ZTools
- 再次尝试唤起 → 预期恢复正常
✅ 预期行为
快捷键和托盘操作应稳定唤起 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 中可见类似记录(含义尚不明确):
启动时快捷键注册日志正常:
快捷键 Alt+Space 注册成功
[Settings] 启动时应用快捷键设置: Alt+Space 成功
🔍 额外信息
🐛 Bug 描述
在 macOS 上,ZTools 有时无法通过全局快捷键(如
Alt+Space)或托盘菜单「显示/隐藏」唤起主窗口,按快捷键或点击托盘均无可见反应。目前已确认的现象:
📋 复现步骤
目前不能稳定复现,以下为出现问题前后的大致操作,仅供参考:
Alt+Space或点击托盘「显示/隐藏」恢复方式(已验证有效):
killall ZTools)✅ 预期行为
快捷键和托盘操作应稳定唤起 ZTools 主窗口,不应依赖重启才能恢复。
❌ 实际行为
📸 截图
无。
💻 环境信息
/Applications/ZTools.app)Alt+Space(默认)📝 错误日志
出现问题期间,
~/Library/Application Support/ZTools/logs/main.log中可见类似记录(含义尚不明确):启动时快捷键注册日志正常:
🔍 额外信息