快捷键没反应——权限检查 + 重启 + 监听器状态三步排查

第一步：确认权限

macOS

打开「系统设置 → 隐私与安全性」，检查三项：

1. ✅ 麦克风——OpenLess 必须有麦克风权限才能录音
2. ✅ 辅助功能——OpenLess 必须有辅助功能权限才能监听全局热键、读写光标位置
3. ✅ 输入监控（某些 macOS 版本）——某些系统版本还需要额外授予输入监控权限

授权后必须完全退出并重新启动 OpenLess——辅助功能权限只在重启后生效。直接关窗口没用，要用 Cmd + Q 完全退出。

Windows

打开 OpenLess → 设置 → 权限，检查全局快捷键监听器状态：

• 状态显示已启动 → 监听器正常，继续往下排查
• 状态显示未启动或报错 → 点「重新启动监听器」或重启 OpenLess

同时确认麦克风权限没被拒绝过：系统设置 → 隐私和安全性 → 麦克风。

Linux

• 确认窗口管理器/合成器支持全局热键（Wayland 合成器支持有限）
• GNOME 等桌面环境可能需要额外授权
• 默认快捷键是 Ctrl + /，试试换一个组合键

第二步：重启 OpenLess

这听起来像废话，但90% 的 macOS 快捷键问题重启后就解决了：

1. 完全退出 OpenLess（托盘图标 → 退出，或 Cmd + Q）
2. 重新打开 OpenLess
3. 回到正常使用场景（光标在目标输入框里），按快捷键试试

第三步：确认没有冲突

快捷键被其他应用占用

macOS 和 Windows 都不允许两个应用注册同一个全局热键。在 OpenLess 设置里把快捷键换成一个不太可能冲突的（比如换另一个修饰键组合）。

安全软件拦截（Windows）

反病毒软件、企业管控软件、键盘记录器防护软件——这些都可能拦截全局键盘钩子。检查：

• Windows Defender 有没有把 OpenLess 的键盘钩子误判
• 企业管控软件有没有禁止非授权应用注册全局热键
• 临时退出安全软件测试一下

第四步：看日志

如果上面几步都不管用，打开日志看 OpenLess 内部报了什么：

在日志里搜索关键词：

• hotkey / keyboard——看热键监听模块的状态
• permission / accessibility——看权限检查结果
• error / fail——看有没有错误堆栈

不同平台的高频坑

macOS 专属

• 辅助功能授权后没重启 OpenLess——这是 macOS 的硬性要求，不重启=授权没生效
• 输入监控没授权（macOS Ventura+）——某些版本需要额外授予「输入监控」权限
• 安全输入模式（Terminal、密码框）——某些安全场景下 OpenLess 被系统屏蔽（正常行为）

Windows 专属

• 监听器显示未启动——OpenLess 设置 → 权限 → 点「重新启动监听器」
• UIPI 权限不一致——游戏以管理员运行、OpenLess 不是（或反过来），Windows 阻止按键消息传递。让两者权限对齐。
• Electron 编辑器光标上下文读不到——VS Code 等，需要设 accessibilitySupport: on

Linux 专属

• Wayland 合成器限制——某些 Wayland 合成器不支持 OpenLess 的全局热键注册。建议在 X11 下运行，或换个对全局热键支持更好的合成器。

快捷键没问题但录音没声音

如果快捷键有反应（状态胶囊显示「录音中」）但 ASR 返回错误或空结果，问题在凭据或 ASR 提供商配置——不是快捷键的问题。去 首次配置 检查凭据填对了没有。