/status 会列出坏掉的配置了:agent、技能、快捷键、hook 问题一屏看清
写了一个自定义 agent,却怎么也调不出来;配了 PreToolUse hook,看起来就是不触发;在 /config 里改了某一项,重开之后好像没生效……这类「配置静默失败」以前很难查,只能逐个文件翻。
2.1.327 把这些问题集中到了 /status 里。
/status 现在会列出什么
升级后运行 /status,如果有问题,会看到一份清单,涵盖:
- 加载失败的文件:agent、skill、自定义命令、输出样式(output style)文件,比如 frontmatter 写错、格式不对。
- 快捷键错误:
keybindings里无法解析或有冲突的条目。 - 沙箱不可用:开启了沙箱,但当前环境实际上跑不起来。
- 被忽略的权限设置:写了但没有生效的权限规则或相关配置。
- 永远匹配不上的 hook matcher:例如 matcher 里写的工具名根本不存在,hook 永远不会被调用。
这些原本都是「不报错、也不起作用」的状态,现在至少有个地方能一眼看到。
/config 的覆盖提示
同一版本里,/config 也加了一条说明:当某一行的值被其他设置覆盖时(比如托管设置、项目设置或环境变量优先级更高),会在该行标注出来。你在界面上改了却没效果,多半就是这个原因。
另外,/config 等命令保存设置失败时,以前不会有任何提示;2.1.327 起会在输入框下方显示一行说明,不会再让你误以为已经保存成功。
建议的排错顺序
- 先跑
/status。新加 agent、skill 或 hook 之后,习惯性看一眼有没有出现在问题清单里。 - hook 不触发时,重点看 matcher。如果
/status提示 matcher 永远不匹配,检查工具名的大小写和写法,比如Bash、Edit、mcp__服务器名__工具名。 - 设置不生效时,到
/config找覆盖标记。确认是不是更高优先级的设置把它压住了,再决定改哪一层。 - 沙箱显示不可用时,回头检查平台依赖和沙箱相关设置,别以为命令已经在沙箱里跑了。
一句话:配置出问题时,先看 /status,再看 /config,大部分「为什么没生效」都能在这两处找到线索。