Cursor 3.11 在 2026 年 7 月 10 日发布后，补上了三个直接面向 Agent 工作流的新功能：侧边聊天、对话搜索和云端 Agent Hooks。它们解决的是同一个问题——主 Agent 正在执行长任务时，用户不必停下主线，也��查询信息、回看历史记录，或在关键节点插入自动化脚本。
侧边聊天继承上下文，主任务无需停下
侧边聊天（side chat）适合主 Agent 正在处理重构、排错这类持续时间较长的任务时使用。用户可以通过在聊天框输入 /side 或 /btw，也可以点击聊天面板顶部的加号按钮，另开一条新对话。
这条侧边聊天会直接继承主对话的 context，因此不用重复粘贴背景信息。默认情况下，它只负责读取、搜索和回答，不会直接改动代码。若要让它执行修改，必须在对话中明确提出。每条侧边聊天都会被长期保留，后续可以继续追问，也能通过 @ 再带回主对话。
Cmd+K 搜全部历史，Cmd+F 查当前长对话
Cursor 3.11 将对话搜索拆成两个层级。在 Agents Window 中按 Cmd+K，可以调出命令面板，直接搜索 Agent 对话内容，而不只是名称或 PR 编号。官方说明里提到，搜索索引建立在本机，所以即便本地累计了几千条历史对话，检索速度仍然较快，内容��不会因为搜索被上传到云端。
若只想在当前这条对话里定位某一段内容，则使用 Cmd+F。这个搜索会显示匹配数量，并支持在结果之间跳转。刚升级到 3.11 后，如果出现旧对话暂时搜不到，或 chat history 看起来为空，原因通常是本地索引仍在建立，而不是数据丢失。
Agent Hooks 可接入关键节点
这次更新里，Hooks 是开发者更关心的一部分。Cursor 允许在 Agent 对话的关键节点挂接自定义脚本，Agent 运行到对应阶段时就会触发。3.11 新增的节点包括 beforeSubmitPrompt、afterAgentResponse、afterAgentThought、subagentStart、subagentStop 和 stop。
这些节点覆盖了提示词提交前、回复完成后、思考结束后，以及子 Agent 启动和结束等过程。可用于监控执行过程，也可在子 Agent 前后插入控制逻辑，还能搭建自动纠错流程，例如在 Agent 回复后自动运行测试，再把错误返回给它继续处理。
hooks.json 放置位置与执行方式
Hooks 配置文件名为 hooks.json，其中 version 固定填写 1。可放在三个位置：项目目录下的 .cursor/hooks.json、用户全局目录 ~/.cursor/hooks.json，以及企业级目录 /etc/cursor/hooks.json。只要存在，就会执行。
文中给出的最小示例是在 afterFileEdit 节点运行稽核脚本，在 stop 节点记录一次任务结束事件。脚本通过标准输入接收 JSON 数据，其中包含 conversation_id、generation_id、model 和 hook_event_name 等字段；不同节点还会附带各自对应的信息，例如 beforeSubmitPrompt 会包含 prompt，afterAgentResponse 会带上回复文本。
只有两个节点支持拦截动作
并不是所有 Hook 都能真正阻止某个动作执行。Cursor 当前只在 beforeShellExecution 和 beforeMCPExecution 两个节点读取脚本标准输出中的 JSON 结果，并据此决定是否继续执行。返回值中的 permission 可以设为 allow、deny 或 ask。
其他节点即便也输出 permission，系统不会处理。它们能做的是观察、记录或触发其他动作，不能直接拦截执行。
云端 Agent 的限制在 beforeSubmitPrompt
如果 Hooks 用在云端 Agent，一个明确的限制是 beforeSubmitPrompt 不会生效。原因是这个 Hook 绑定在 session 刚开始的生命周期，但云端虚拟机是在 session 启动后才创建，Hook 触发时运行环境还不存在。
原文建议，云端场景更适合使用与工具执行前后相关的节点，例如 beforeShellExecution、afterFileEdit、subagentStart、subagentStop 和 stop。这类节点在云端执行更稳定。
三个功能可串成一套不中断流程
在实际使用中，这三个功能可以连起来。主 Agent 处理跨多个文件的重构时，用户可先通过侧边聊天调查某个接口的调用范围，再把结论通过 @ 带回主对话。同时，hooks.json 可以在任务结束后自动触发测试；如果还要回看当前长对话里 Agent 改了哪些函数，再用 Cmd+F 检索即可。
整个过程里，主 Agent 不需要被打断。查询、追问、检索和自动化检查各自分层完成。