提示与 Plan Mode

提示 Agent

在聊天输入框里用文本提示指挥 Agent。你可以附加上下文、图片和语音，并随时切换模型。

@ 提及

在聊天输入框里输入 @ 给提示附加特定上下文，@ 之后开始输入时 Cursor 会显示匹配的建议：

• 文件与文件夹：@auth.ts 或 @src/components/ 包含文件或文件夹（选中文件夹后输入 / 可以向更深处导航）
• 终端：@Terminals 包含终端输出作为上下文
• 聊天：@Chats 引用之前对话的上下文
• Git diff：@Commit (Diff of Working State) 表示未提交的改动，@Branch (Diff with Main) 表示整个分支的 diff
• 浏览器：@Browser 附加来自内置浏览器的上下文

当你知道哪些文件相关时用 @ 提及；不确定哪些文件重要时就跳过，Agent 通过自己的搜索找到相关文件。

Custom Modes

在聊天输入框里输入 / 调用 skill。按 Enter 把 skill 附加到一条消息上，随着对话推进它会淡出；要把 skill 用作 Custom Mode 让智能体工作时一直专注于它，从 / 菜单选 skill 后改按 Option+Enter（Mac）或 Alt+Enter（Windows），或在 skill 条目上选 Use as Mode。在 mode 里，skill 每个回合都保留在上下文里，即使智能体工作数小时，直到你退出该 mode。Custom Modes 适合描述「怎样工作」而不是一次性任务的 skill：比如在逐个文件移动时保持一份代码评审清单，或在整个功能开发期间保持一份像 /tdd 这样的团队手册。任何有有效 frontmatter 块的 skill 都可以支撑一个 mode，可选的 icon 和 color frontmatter 字段给 mode 的徽章设置样式。Custom Modes 在 Agents Window 和 CLI 里可用。

图片与语音输入

• 附加图片给提示提供视觉上下文，用于界面工作、调试和设计实现：把图片文件拖放到聊天输入框，或用 Cmd+V 从剪贴板粘贴（包括截图）。适合实现设计稿、调试视觉问题，以及引用错误消息或堆栈跟踪而无需手工转录
• 点击聊天输入框里的麦克风图标可以口述提示而不是打字：自然地说话，包含文件和函数名等技术细节，发送前检查转写结果

上下文用量

每个聊天都与模型共享固定的上下文窗口。随着你添加文件、运行工具和交换消息，这些 token 会被填满；窗口接近满时，Cursor 把对话中较早的部分压缩成摘要，为新的对话腾出空间。提示输入框旁边的上下文环一眼显示窗口有多满，点击它打开明细托盘，按类别显示总 token 用量：系统提示（Cursor 给模型的内置指令）、工具（智能体可用的每个工具的定义）、规则（包含在提示里的项目和用户规则）、Skills（注入系统上下文的 skill 描述）、MCP（来自已连接 MCP 服务器的指令和目录）、子智能体（智能体可以启动的子智能体类型的文档）、摘要的对话（较早回合的压缩摘要）、对话（你的消息、智能体的回复和工具结果）。

切换模型

用聊天输入框顶部的模型选择下拉框切换模型，或按 Cmd / 循环切换；更改应用于当前对话之后的内容，默认模型在 Cursor Settings > Models 里设置。更快的模型适合快速编辑和常规任务，更强的模型更适合复杂推理和多文件重构；可以在对话中途切换，例如较快的模型做了探索，但实现需要更深的推理时。

Plan Mode

Plan Mode 在写任何代码之前创建详细的实现计划：Agent 研究你的代码库、提出澄清问题，并生成你可以在构建前编辑的可评审计划。在聊天输入框里按 Shift+Tab 旋转到 Plan Mode；当你输入表示复杂任务的关键词时，Cursor 也会自动建议它。

工作方式：Agent 提出澄清问题以理解你的需求；研究代码库收集相关上下文；创建全面的实现计划；你通过聊天或 markdown 文件评审和编辑计划；准备好时点击构建计划。计划默认保存在你的主目录；点击「Save to workspace」把它移到你的工作区，供将来参考、团队共享和归档。

何时使用：有多种可行方案的复杂功能；涉及很多文件或系统的任务；需求不明确、需要先探索才能理解范围；想先评审方案的架构决策。快速改动或你已经做过很多次的任务直接用 Agent 模式即可。

从计划重新开始：有时 Agent 构建出来的东西与你想要的不符。与其用后续提示去修，不如回到计划：撤销改动，把计划细化得更具体，再运行一次，这通常比修复进行中的智能体更快，结果也更干净。对更大的改动，花额外时间创建精确、范围明确的计划；难点往往是弄清楚该做什么改动，有了正确的指令，就把实现委派给 Agent。用 Agent 里的模式选择下拉框或 Shift+Tab 切换模式。