用途:为 Cursor 智能体循环提供基于文件的钩子,而非编程式回调。SDK 不暴露用于智能体循环的 JavaScript 回调,需使用 .cursor/hooks.json 并通过 local.settingSources 加载。
主要能力与典型场景:在智能体提交前执行 lint/类型检查门禁;每轮结束后执行审计日志或合规命令;执行与提示词无关的快速失败策略。
使用方式:在项目中创建 .cursor/hooks.json,配置 pre/post 命令;通过 local.settingSources 加载钩子,并区分项目、用户、团队作用域。需 JavaScript 回调(如 onDelta、onStep)时应参考程序化替代方案。
相关概念:文件格式见 references/file-format;加载与作用域见 references/loading;程序化替代见 references/programmatic-alternatives。
限制:资料未提供具体 hooks.json 字段、命令示例、平台与收费信息,暂未提供;实际配置需核对官方文档。