跳到主要内容

手动模式（Manual Mode）

手动模式（Manual mode）专为针对性代码修改而设计，适用于您已明确知晓需要修改哪些代码以及具体修改内容的情况。

与智能代理模式（Agent mode）不同，该模式不会主动探索代码库或执行终端命令，它完全依赖于您提供的具体指令和上下文信息（例如通过@提及文件来提供上下文）。

Manual功能概览​

✏️

精准代码编辑

严格按用户指示执行精确的代码变更操作

📜

指令直译执行

严格遵循用户指令操作，不进行自主探索或规划

🔗

多文件协同编辑

支持跨多个指定文件进行协调性修改

🛠️

专注型工具集

核心聚焦文件编辑功能，暂不提供搜索和终端工具


信息

建议阅读chat 功能概述以深入了解 Cursor 的模式运作机制

使用手动模式​

手动模式为代码编辑提供了更精准和定向的操作方式。该模式适用于当您明确知晓需要修改的具体内容和位置时，进行有针对性的代码调整。

要使用手动模式，您需要通过 @ 符号明确指定需要编辑的文件。

1

理解请求

像常规聊天一样创建您的修改请求。

2

探索代码库

通过 `@` 符号指定需要编辑的文件，为请求添加上下文。

3

规划修改

应用修改后，您可以查看变更内容。如果配置了代码检查工具，手动模式会标记潜在问题。

4

执行变更

当编辑操作应用完成后，即视为任务完成。

备注

手动模式在需要精确控制的场景中表现卓越，如同一位 AI 结对编程伙伴，忠实执行您的具体方案。为获得最佳效果，请提供清晰的上下文和操作指令。

示例使用场景​

提示

请提供明确的文件路径（使用 @ 符号）并清晰描述您期望的修改内容。

重构特定函数

“在 @src/utils/helpers.ts 和 @src/components/UserProfile.tsx 文件中，
将函数 `getUserData` 重命名为 `fetchUserProfile`，并更新这些文件内的所有调用点。”

手动模式将执行以下操作：

  1. 仅定位指定文件内的 getUserData 函数定义和调用点
  2. 按照指示重命名函数并更新所有调用点

添加模板代码

“在 @src/newModule.js 和 @src/newService.java 文件顶部添加标准版权声明注释”

手动模式将执行以下操作：

  1. 打开指定文件
  2. 在文件起始位置插入预设的头部注释

配置选项​

  • 选择模型：为手动模式预设专用模型
  • 编辑快捷键：设置自定义快捷键快速激活手动模式
  • 可用工具：手动模式主要使用文件编辑工具，搜索和终端工具将被禁用