手动模式
Manual Mode
Manual 模式
通过明确的文件定位进行精确代码更改——一种专注的编辑模式,用户完全控制工具的使用。
Manual 模式专为需要对代码进行精准修改的场景设计,适用于您明确知道需要修改内容及其位置时使用。
与 Agent 模式不同,Manual 模式不会探索代码库或运行终端命令;它完全依赖您的具体指令和您提供的上下文(例如,通过 @ 提及文件)。
Manual 的功能
精准编辑
根据用户的指示,精确应用特定的代码更改。
直接指令
遵循用户命令,不进行任何自主探索或规划。
跨文件编辑
可以在多个指定文件中进行协调修改。
专注工具集
主要使用文件编辑功能;不支持搜索和终端工具。
请阅读 Chat 概览 以了解 Cursor 中模式的工作原理。
使用 Manual 模式
Manual 模式允许更精准和针对性的代码编辑。它适合在您明确知道需要修改的内容和位置时使用。
要使用 Manual 模式,您需要显式提及要编辑的文件,使用 @ 符号标记。
工作流程
-
🧠 理解请求
在聊天界面中像往常一样创建请求。 -
🔍 提供代码库上下文
使用 @ 符号提及您想要编辑的文件,为请求添加上下文。 -
📝 规划更改
在应用更改后,您可以审查这些更改。如果配置了 linter,Manual 模式可能会标记潜在问题。 -
🔧 执行更改
一旦应用更改,任务即被视为完成。
Manual 模式在需要高度控制和精确性时表现出色,充当了一个执行您特定计划的 AI 配对程序员。提供清晰的上下文和指令以获得最佳效果。
示例用例
通过提供明确的文件路径(使用 @)和清晰的修改说明来实现目标。
重构特定函数
示例:
“在 @src/utils/helpers.ts 和 @src/components/UserProfile.tsx 中,将函数 getUserData
重命名为 fetchUserProfile
,并更新这些文件中的所有调用点。”
Manual 模式将:
- 定位指定文件中
getUserData
函数的定义和调用点。 - 重命名函数并按照指示更新调用点。
应用样板代码
示例:
“在 @src/newModule.js 和 @src/newService.java 文件顶部添加标准版权头注释。”
Manual 模式将:
- 打开指定文件。
- 在每个文件的开头插入提供的头部注释。
配置选项
- 选择模型: 为 Manual 模式预先选择特定的模型。
- 编辑快捷键: 设置自定义快捷键以快速激活 Manual 模式。
- 可用工具: Manual 模式主要使用文件编辑工具,不支持搜索和终端工具。