Codex Superpowers 插件的 Shift+Alt 快捷键突然没反应了?别急着怀疑插件本身,大概率不是它“罢工”了,而是快捷键被其他扩展或者系统功能给截胡了。比如 VSCode 里装了 Emacs Keymap、Vim 这类扩展,或者在 Mac 上开启了“慢速键”辅助功能——这些都会让 Shift+Alt 组合键在关键时刻失效。下面一步步排查,稳稳解决。

确认快捷键是否真被占用
打开 VSCode,进入“文件 > 首选项 > 键盘快捷方式”(或者直接按 Ctrl+K Ctrl+S),然后在搜索框输入 codex 或 superpowers。重点看右侧命令列里有没有 codex.superpowers.trigger 或者类似的条目,并且它的绑定的确显示为 Shift+Alt 加上某个键(比如 Shift+Alt+P)。如果这个快捷键显示为灰色,旁边还标着“已禁用”,那就说明被更高优先级的规则覆盖了;如果压根儿没出现这条命令,那说明插件根本没注册成功——这种情况更常见。
Windows 平台:排查 PowerShell/CMD 终端冲突
这个插件的触发依赖底层 CLI 调用,而 Codex CLI 在 Windows 上必须通过 WSL2 或 PowerShell 才能运行——CMD 和 Git Bash 默认不加载 Node.js 全局模块路径。你可以在 VSCode 里打开集成终端,先执行 node -v 和 codex --version。如果 codex --version 报错“不是内部或外部命令”,那就说明当前终端压根没识别到全局安装的 Codex。这种情况下 Shift+Alt 按多少次都没用,因为启动入口不存在。必须确保终端是 PowerShell(不是 CMD)而且以管理员身份运行,否则 npm 全局安装的包不会被 PATH 捕获。
Mac 平台:检查系统级辅助功能干扰
方法一:临时关闭“慢速键”。去系统设置 → 辅助功能 → 键盘,把“启用慢速键”关掉。
方法二:重置 Modifier 键映射。系统设置 → 键盘 → 键盘快捷键 → 输入源,点击右下角“修改键…”,恢复为默认设置——尤其注意检查 Option/Alt 键有没有被映射成其他功能。Mac 对 Alt 键(也就是 Option 键)的处理特别敏感,第三方输入法(比如鼠须管、Squirrel)常常偷偷劫持 Alt+Shift 组合,导致 VSCode 收不到原始按键事件。
强制刷新插件注册状态
第一步:禁用并重新启用 Codex Superpowers 插件。
第二步:重启 VSCode——不是重新加载窗口,是彻底退出再打开。
第三步:在命令面板(Ctrl+Shift+P / Cmd+Shift+P)里输入 Codex: Reload Plugins 并执行。
第四步:打开开发者工具(Help → Toggle Developer Tools),切换到 Console 标签页,输入 codex.plugins.list() 并回车。如果返回空数组或者报 ReferenceError,说明插件没加载;如果返回包含 superpowers 的对象,则插件已就绪,问题就出在快捷键链路上。这一步能绕过 VSCode 的缓存机制,直接触发插件初始化流程,比单纯重启更可靠。
终极修复:手动绑定快捷键
方法一:在键盘快捷方式设置中,右键点击 codex.superpowers.trigger,选择“更改键绑定”,然后按下你希望的新组合(比如 Cmd+Shift+X),回车确认。
方法二:编辑 keybindings.json。打开命令面板,输入 Preferences: Open Keyboard Shortcuts (JSON),然后在数组末尾添加:
{ "key": "shift+alt+p", "command": "codex.superpowers.trigger", "when": "editorTextFocus" }
注意:如果之前有冲突规则,这条新规则必须放在文件末尾才能生效——VSCode 按顺序匹配,后写的优先级更高。
