Manual 模式
通过明确指定文件进行精确的代码更改——这是一个以用户为主导、专注编辑的模式。
Manual 模式适用于你清楚知道需要修改哪些内容和位置时的定向代码修改。
与 Agent 模式不同,Manual 不会主动探索代码库或运行终端命令;它完全依赖于你提供的具体指令和上下文(例如通过 @ 引用文件)。
Manual 的能力
精确编辑
根据用户的指示,准确地应用特定的代码更改。
直接指令
严格按照用户命令执行,不进行自主探索或规划。
多文件编辑
可以在多个指定文件中进行协调修改。
专注工具集
主要使用文件编辑功能,不包含搜索和终端等工具。
💡 请务必阅读 Chat 概览,以了解 Cursor 中各类模式的工作方式。
使用 Manual 模式
Manual 模式允许你以更精确和有针对性的方式进行代码编辑。它适用于你清楚知道需要修改哪些内容和位置时的定向代码更改。
要使用 Manual 模式,你需要通过 @
符号明确指定你想要编辑的文件。
- 1
🧠 理解需求
Agent 像平常一样在聊天中创建你的需求。
- 2
🔍 探索代码库
通过使用
@
符号提及你想要编辑的文件,为你的请求添加上下文。 - 3
📝 规划更改
应用更改后,你可以审查这些更改。如果配置了 linter,Manual 模式可能会标记潜在问题。
- 4
🔧 执行更改
一旦编辑被应用,任务就视为完成。
💡 当你需要控制和精确性时,Manual 模式表现尤为出色,相当于一个按照你具体方案执行的 AI 结对程序员。请提供清晰的上下文和指令,以获得最佳效果。
示例用法
💡 请提供明确的文件路径(使用 @ 符号)以及对你希望进行的更改的清晰描述。
“In @src/utils/helpers.ts and @src/components/UserProfile.tsx,rename the function getUserData to fetchUserProfile and update all call sites within these files.”
Manual 模式将会:
- 仅在指定的文件中定位 getUserData 函数的定义和调用。
- 按照你的指示重命名该函数,并更新所有调用位置。
应用样板代码
“Add the standard copyright header comment to the top of @src/newModule.js and @src/newService.java”
Manual 模式将会:
- 打开指定的文件。
- 在每个文件的开头插入你提供的头部注释。
配置选项
- 选择模型:为 Manual 模式预先选择专用模型。
- 编辑快捷键:设置自定义快捷键以快速激活 Manual 模式。
- 可用工具:Manual 模式主要使用文件编辑工具,搜索和终端工具被禁用。