云端与团队 Hooks
区分托管云端、自托管 worker 与本地 Hook 支持，并选择分发范围。
This page has not been translated into English yet. The original Chinese version is shown below.
托管 Cloud Agents 从仓库 .cursor/hooks.json 加载 command hooks。早期探索可能发生在只读环境，期间不运行 hooks，获得可写环境后才开始。
托管云端支持
| 类别 | 事件 |
|---|---|
| 工具与文件 | preToolUse、postToolUse、postToolUseFailure、beforeReadFile、afterFileEdit |
| Shell | beforeShellExecution、afterShellExecution |
| 子任务 | subagentStart、subagentStop |
| 输入与输出 | beforeSubmitPrompt、afterAgentResponse、afterAgentThought |
| 压缩与结束 | preCompact、stop |
托管云端当前不运行 sessionStart/sessionEnd、beforeMCPExecution/afterMCPExecution、Tab hooks 和 workspaceOpen。不要把本地审计策略直接当作云端已经覆盖。
配置来源与自托管例外
项目 hooks 可用；Enterprise 还可用 Team 和 Enterprise-managed hooks。用户本机 ~/.cursor/hooks.json 不会自动进入托管云端 VM。Prompt hooks 因云端认证连接限制不可用。
Self-Hosted Machines 的 Pools 与 My Machines 同样运行 command 项目 hooks，Enterprise 也运行团队和托管 hooks；它们另外会在会话 claim worker 与释放 claim 时触发 sessionStart/sessionEnd。这是自托管 worker 的生命周期，不能套用为所有 Cloud Agents 都有会话事件。
团队分发
| 方式 | 配置与维护 |
|---|---|
| 项目版本控制 | 提交项目 .cursor/hooks.json 和脚本，在 trusted workspace 加载 |
| MDM | 组织自行部署 hooks.json 与脚本到用户或系统目录 |
| Enterprise cloud distribution | dashboard 集中管理，登录后同步，可按操作系统定向 |
官方 cloud distribution 同步周期为 30 分钟。Cursor 不负责组织 MDM 工具的文件部署与更新；修改策略后应在实际客户端和执行环境确认已加载。