钩子从哪来一眼可见:2.1.329 信任对话框、托管钩子告警与 /mcp、/status 新诊断行
钩子(hooks)很强大:它能在工具调用前后自动执行命令,替你拦截、改写或记录操作。但也正因为它会"自动执行",打开一个陌生仓库时,你最该知道的问题之一就是:这里有没有钩子?它们写在哪个文件里?
2.1.329 在这件事上做了几处透明度改进。
1. 信任对话框会说明钩子声明在哪里
第一次在某个文件夹里启动 Claude Code 时,会弹出信任对话框。2.1.329 起,这个对话框会附带一条警告,指出该文件夹的钩子是在哪里声明的。
这意味着你在点"信任"之前,就能知道钩子来自哪个配置文件,可以先打开看看它到底会跑什么命令。对于从网上克隆的仓库、同事临时发来的项目,这一步尤其值得花几秒钟。
2. 托管钩子加载失败,不再悄无声息
企业管理员可以通过托管设置(managed settings)统一下发钩子,比如审计日志或合规检查。问题是,在 Claude Desktop 这类非交互宿主里,如果这些钩子没能加载,用户往往察觉不到,还以为保护措施在生效。
2.1.329 起,托管设置中的钩子加载失败时,会在对话里显示警告,适用于 Claude Desktop 及其他非交互宿主。看到这条警告,就该联系管理员检查配置了。
3. /mcp:远程服务器拒绝连接时能看到原因
远程 HTTP MCP 服务器拒绝连接时,过去你通常只知道"连不上"。现在在 /mcp 里打开该服务器的页面,会多出一行 「Server message」,显示服务器返回的 JSON-RPC 错误信息。认证失败、权限不足还是服务端报错,看这一行就能先判断个大概。
4. /status:哪些托管插件市场不会自动更新
/status 新增 「Marketplace auto-update」 一行,会列出不会自动更新的托管插件市场,并说明原因。如果你发现某个团队插件迟迟没有新版本,先来这里看看是不是市场本身被排除在自动更新之外。
实用建议
- 打开新仓库时,认真看一眼信任对话框里关于钩子的那条提示,不确定就先去对应文件里检查;
- 团队如果依赖托管钩子做合规,提醒成员留意对话里的加载失败警告;
- 排查 MCP 或插件问题时,先看
/mcp的 Server message 和/status的 Marketplace auto-update,再决定下一步。
小结
这几处改动的共同点是:把原来"静默发生"的事情摆到台面上。钩子从哪来、托管配置有没有生效、服务器为什么拒绝、插件为什么不更新,现在都有地方可查。