#8. Agent 与 Composer

#Agent 模式

Agent 是 Cursor 最强大的功能。按 Ctrl/Cmd + I 打开 Composer 面板，切换到 Agent 模式后，AI 可以：

1. 自主规划：分析任务需求，制定执行步骤
2. 搜索代码库：自动查找相关文件和代码
3. 编辑多文件：跨文件协调修改
4. 运行命令：执行终端命令、安装依赖、运行测试
5. 迭代修正：根据测试结果或报错自动修复

典型使用：

我需要给用户系统添加邮箱验证功能：
1. 发送包含验证链接的邮件
2. 验证链接的处理接口
3. 用户状态更新
4. 相关的单元测试

Agent 会自动完成全部工作，你只需逐步审查每一步的改动。

#Composer 工作流

Cursor 2.0 引入了 Composer 模型（混合专家模型，通过强化学习训练），专为代码编辑优化：

• 速度：大多数任务在 30 秒内完成
• Plan Mode：先生成执行计划供你审查，确认后再执行
• Parallel Planning：用多个模型并行生成方案，选择最优方案执行

Plan Mode 使用建议：

[开启 Plan Mode]
重构整个认证模块，将 session-based 改为 JWT-based

→ AI 生成计划：
  Step 1: 创建 JWT 工具函数
  Step 2: 修改登录接口
  Step 3: 创建中间件
  Step 4: 更新路由保护
  Step 5: 编写测试
  Step 6: 更新文档

→ 你审查计划后确认执行

#多文件协同

Agent 和 Composer 的核心优势在于跨文件编辑。一次指令可以同时修改：

• 数据库模型、API 路由、控制器、前端组件、测试文件
• 所有修改以统一的 diff 展示，保持逻辑一致性

#执行边界

Agent 在以下场景可能需要人工介入：

• 涉及外部服务的配置（数据库连接、第三方 API）
• 需要访问敏感凭证的操作
• 对生产环境有影响的操作

#风险控制

Cursor 2.0 默认启用了沙盒终端（macOS）：

• Agent 执行的命令默认在沙盒中运行
• 沙盒对工作区目录有读写权限，但无网络访问权限
• 非白名单命令需要用户确认
• 企业版可在管理后台集中配置沙盒策略