Cursor Side Chat 怎么用:主 Agent 不停、旁路问答与对话搜索

Cursor 3.11 的 Side Chat(/side、/btw)与 Agents Window 对话搜索(Cmd+K / Cmd+F)用法、适用边界、常见踩坑,以及和主 Agent、Cloud hooks 的分工。

Cursor Side Chat 怎么用:主 Agent 不停、旁路问答与对话搜索

主 Agent 正在改半个模块,你突然想起「这个鉴权以前怎么写的」——若塞进同一条线程,上下文会被带偏,进度也被打断。Cursor 3.11(changelog 标注 2026-07-10)给出的解法是:Side Chat 旁路会话 + 可搜索的历史 transcript。依据 官方 Side Chat changelog;命令以你本机版本为准。

Side Chat 解决什么问题

打开方式有三种:输入 /side、输入 /btw,或点聊天面板顶部的加号。新开会话会带上主会话上下文,但是独立、可持久、可回访的完整 Agent 对话;之后可用 at-mention 把旁路结论拉回主线程。

官方默认定位偏「读、搜、答」:

  • 澄清一个事实或接口含义
  • 调研备选方案,却还不想让主 Agent 转向
  • 主 Agent 还在跑时,做一次 sanity check

它不是「再开一个无限制乱改仓库的小号主对话」。大范围改文件、换架构,应停主任务或新开执行向会话,并写清范围——可对照 Agent 模式排查

一套可复制的用法

场景 A:主任务在跑,你要核对。
主 Agent 继续;Side Chat 问「AuthMiddleware 现在校验的是 JWT 还是 session?」要求只读文件、给结论。确认后 at-mention 回主线程一句「按 side chat 结论继续」。

场景 B:怕主线程被带偏。
想比较「用 Redis 还是内存缓存」时,先 Side Chat 列利弊与改动面;决定后再回主会话下指令。避免主线程里来回打架。

场景 C:找回历史结论。
上周 Agent 贴过一段 SQL,会话标题却是 Untitled。打开 Agents Window,用命令面板 Cmd+K(Windows 多为 Ctrl+K)搜 transcript 正文里的报错或文件名;已打开的长会话里用 Cmd+F 跳匹配。官方称索引在本地,可撑到上千条会话。

和同版其它改动别混在一键里

3.11 还改了项目/仓库选择器:搜索按 This Computer / Cloud / 远程机分区;可在 picker 里建项目并接 GitHub、GitLab、Azure DevOps;无仓库工作是明确的 No Repo(输入 noneno repo 可搜到)。这和 Side Chat 无关,但开 Agents Window 时会一起撞上。

同版还加了 Cloud Agent 对话级 hooks(如 beforeSubmitPromptafterAgentResponse 等),用于观察与管控云端对话本身。本地 Side Chat 是个人流控;hooks 是团队云端治理——需要团队策略时再读官方 hooks 文档,不要指望 /side 代替合规门禁。

常见失效与误用

现象 先查什么
/btw 无反应 版本是否 ≥ 3.11;改用面板加号;重启窗口
旁路也开始大改文件 你是否给了「直接改」指令;默认应偏只读,明确禁止写盘
搜不到旧会话 是否在 Agents Window 用 Cmd+K;是否搜的是正文关键词而非标题
和 CLI 工作流搅在一起 CLI 是另一条入口;Side Chat 是 IDE/Agents Window 旁路

Composer 与 Chat 的分工见 Composer vs Chat;总选型见 Cursor 还值不值得换

什么时候用旁路,什么时候别用

  • 主任务还在跑,只想核对一个事实 → Side Chat。
  • 准备换方案、要动很多文件 → 停主任务或新开主会话。
  • 把侧栏当「第二个工地」长期并行大改 → 用多会话/多 agent,并接受更高的冲突成本,而不是滥用 Side Chat。
  • 需要组织级拦截危险工具 → Cloud hooks / 团队策略,不是个人 /btw

一句话:Side Chat 是走廊问询,不是第二间装修现场。

常见问题

Side Chat 会不会消耗和主会话一样的额度?

会占用模型用量;具体计费以账户面板为准。旁路适合短问短答,把长重构放回主会话更清晰。

能不能多个 Side Chat 同时开?

可以开多个旁路,但人的注意力有限。超过两个并行旁路时,建议把结论写进 issue/笔记,关掉闲置会话。

和 Claude Code 的子代理是一回事吗?

不是。Side Chat 是 Cursor 产品内的旁路对话;Claude Code 子代理是另一套编排。不要混配置、混预期。

参考资料