Manual 模式

通过明确指定文件进行精确的代码更改——这是一个以用户为主导、专注编辑的模式。

Manual 模式适用于你清楚知道需要修改哪些内容和位置时的定向代码修改。

与 Agent 模式不同,Manual 不会主动探索代码库或运行终端命令;它完全依赖于你提供的具体指令和上下文(例如通过 @ 引用文件)。

Manual 的能力

精确编辑
根据用户的指示,准确地应用特定的代码更改。
直接指令
严格按照用户命令执行,不进行自主探索或规划。
多文件编辑
可以在多个指定文件中进行协调修改。
专注工具集
主要使用文件编辑功能,不包含搜索和终端等工具。
💡 请务必阅读 Chat 概览,以了解 Cursor 中各类模式的工作方式。

使用 Manual 模式

Manual 模式允许你以更精确和有针对性的方式进行代码编辑。它适用于你清楚知道需要修改哪些内容和位置时的定向代码更改。

要使用 Manual 模式,你需要通过 @ 符号明确指定你想要编辑的文件。

  1. 1

    🧠 理解需求

    Agent 像平常一样在聊天中创建你的需求。

  2. 2

    🔍 探索代码库

    通过使用 @ 符号提及你想要编辑的文件,为你的请求添加上下文。

  3. 3

    📝 规划更改

    应用更改后,你可以审查这些更改。如果配置了 linter,Manual 模式可能会标记潜在问题。

  4. 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 模式主要使用文件编辑工具,搜索和终端工具被禁用。