WorkBuddy在macOS上快捷键失效是因系统级权限缺失或冲突所致；需依次确认辅助功能授权、排查系统/第三方快捷键覆盖、检测后台进程劫持，并清除隔离属性确保监听模块正常加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 在 macOS 上的快捷键冲突不是“偶尔不灵”，而是系统级拦截或权限覆盖导致的确定性失效——比如 Cmd + Shift + D 打不开调试面板，大概率不是按键没按对，而是被其他进程劫持、被系统快捷键屏蔽，或 WorkBuddy 本身没拿到辅助功能权限。
确认 WorkBuddy 是否具备辅助功能权限
macOS 要求所有能监听全局快捷键（尤其是带 Cmd 的组合）的应用，必须显式获得「辅助功能」授权。没有这一步，Cmd + Shift + D 等调试快捷键根本不会被系统转发给 WorkBuddy。
- 打开「系统设置 → 隐私与安全性 → 辅助功能」
- 点击左下角锁图标解锁（需输入密码）
- 点击「+」号，导航到
/Applications/WorkBuddy.app，选中并添加 - 确保其左侧复选框已勾选；若已存在但未勾选，手动勾选后重启 WorkBuddy
- 注意：仅添加到「完全磁盘访问」不够，辅助功能权限是独立开关
检查系统级快捷键是否覆盖了 WorkBuddy 的组合键
macOS 原生快捷键（如聚焦搜索、输入法切换）和第三方工具（如 Alfred、Raycast、alt-tab-macos）经常抢占 Cmd + Space、Cmd + Tab、Cmd + Shift + D 这类高频组合。WorkBuddy 默认使用的 Cmd + Shift + D 就容易和某些终端/IDE 的调试快捷键冲突。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
- 进入「系统设置 → 键盘 → 键盘快捷键」
- 逐项展开左侧菜单（特别是「聚焦」「输入法」「调度中心」「App 快捷键」）
- 查找是否有条目绑定到了
Cmd + Shift + D；若有，点击它，按Esc清空，或改设为其他组合 - 在「App 快捷键」里点「+」，可为 WorkBuddy 单独指定一个不冲突的替代快捷键（如
Cmd + Option + D），菜单标题填「打开调试面板」（需与 WorkBuddy 内部注册名一致）
验证快捷键是否被其他进程实际占用
有些工具（如录屏软件、远程控制客户端、输入法）会在后台静默注册快捷键，不显示在系统设置里，导致 WorkBuddy 按键无响应且无提示。
- 终端运行：
defaults read NSGlobalDomain NSUserKeyEquivalents 2>/dev/null，查看是否有异常全局映射 - 安装
hotkey-detective工具（git clone https://gitcode.com/gh_mirrors/ho/hotkey-detective），启用实时监控，触发Cmd + Shift + D后看日志里哪个进程真正收到了该事件 - 临时退出 Alfred、Raycast、BetterTouchTool、Karabiner-Elements 等快捷键增强工具，再测试 WorkBuddy 快捷键是否恢复
- 若发现冲突，优先在对应工具中禁用该快捷键，而非强行修改 WorkBuddy 源码或配置文件（它不暴露快捷键重映射入口）
调试模式启动失败时的兜底排查路径
即使辅助功能已开、系统快捷键已清空，Cmd + Shift + D 仍无反应，说明 WorkBuddy 进程可能未正确加载快捷键监听模块——常见于首次启动被 Gatekeeper 中断后残留的权限状态异常。
- 先执行
sudo xattr -rd com.apple.quarantine /Applications/WorkBuddy.app清除隔离属性 - 右键 App →「显示简介」→ 勾选「仍要打开」
- 关闭所有 WorkBuddy 进程（包括后台
WorkBuddy Helper），再用终端启动：/Applications/WorkBuddy.app/Contents/MacOS/WorkBuddy --debug - 观察终端输出中是否有
registerGlobalHotkey: Cmd+Shift+D → success或类似日志；若报failed to register，基本可锁定为权限链断裂
真正的难点不在“怎么设快捷键”，而在于 macOS 把快捷键控制权拆成了至少三块独立权限：辅助功能、完全磁盘访问、应用签名信任。少一块，WorkBuddy 的快捷键就断一截。别跳过任何一项验证，尤其别以为“加了磁盘权限就等于能监听键盘”。
