Lzh on GitHub

代码操作

通过代码操作直接在编辑器中访问 Roo Code 的 AI 帮助。通过 VSCode 的灯泡系统获取即时修复、解释和改进。

代码操作通过 VSCode 的灯泡(快速修复)系统,让你能够直接在代码编辑器中即时访问 Roo Code 的 AI 帮助。这个上下文感知的特性会自动检测相关的代码情况,并提供适当的 AI 驱动操作,而无需你切换到聊天界面。

什么是代码操作?

代码操作在编辑器边槽(行号左侧的区域)中显示为灯泡图标 (💡)。它们也可以通过右键上下文菜单或键盘快捷键访问。它们在以下情况下触发:

  • 你选择了一段代码。
  • 你的光标位于有问题的行上(错误、警告或提示)。
  • 你通过命令调用它们。

点击灯泡、右键单击并选择 “Roo Code”,或使用键盘快捷键(在 macOS 上默认为 Ctrl+. 或 Cmd+.),会显示一个可用操作的菜单。

Roo Code 的代码操作

Roo Code 提供 5 种代码操作,但它们的可用性因上下文而异:

上下文菜单操作(右键单击)

  • 添加到上下文:快速将选定的代码添加到与 Roo 的聊天中,包括文件名和行号,以便 Roo 确切知道代码来自哪里。它在菜单中排在第一位,以便于访问。
  • 解释代码:要求 Roo Code 解释选定的代码。
  • 改进代码:要求 Roo Code 对选定的代码提出改进建议。

附加操作

  • 修复代码:可通过灯泡菜单和命令面板(但不能通过右键菜单)访问。要求 Roo Code 修复选定代码中的问题。
  • 新任务:使用选定的代码创建一个新任务。可通过命令面板访问。

上下文感知操作

灯泡菜单会根据你代码的当前状态智能地显示不同的操作:

对于有问题(VSCode 显示红色/黄色波浪线)的代码

  • 修复代码 - 获取分步指导以解决特定错误或警告
  • 添加到上下文 - 将有问题的代码添加到 Roo 的上下文中进行讨论

对于干净(没有诊断)的代码

  • 解释代码 - 获取代码作用的详细解释
  • 改进代码 - 接收优化建议和最佳实践
  • 添加到上下文 - 将代码添加到 Roo 的上下文中以进行进一步工作

有关诊断如何与代码操作集成的更多详细信息,请参阅诊断集成

深入了解“添加到上下文”

“添加到上下文” 操作在代码操作菜单中排在第一位,以便你可以快速将代码片段添加到对话中。当你使用它时,Roo Code 会在代码中包含文件名和行号。

这有助于 Roo 了解你的代码在项目中的确切上下文,从而提供更相关、更准确的帮助。

示例聊天输入

Can you explain this function?
@myFile.js:15:25

(其中 @myFile.js:15:25 代表通过“添加到上下文”添加的代码)

使用代码操作

使用 Roo Code 的代码操作有三种主要方式:

1. 从灯泡 (💡)

  1. 选择代码:选择要处理的代码。你可以选择单行、多行或整个代码块。
  2. 寻找灯泡:在选定代码旁边的边槽(或有错误/警告的行)中会出现一个灯泡图标。
  3. 点击灯泡:点击灯泡图标打开代码操作菜单。
  4. 选择操作:从菜单中选择所需的 Roo Code 操作。
  5. 审查和批准:Roo Code 将在聊天面板中提出一个解决方案。审查提议的更改并批准或拒绝它们。

2. 从右键上下文菜单

  1. 选择代码:选择要处理的代码。
  2. 右键单击:右键单击选定的代码以打开上下文菜单。
  3. 选择“Roo Code”:从上下文菜单中选择“Roo Code”选项。将出现一个子菜单,其中包含可用的 Roo Code 操作。
  4. 选择操作:从子菜单中选择所需的操作。
  5. 审查和批准:Roo Code 将在聊天面板中提出一个解决方案。审查提议的更改并批准或拒绝它们。

3. 从命令面板

  1. 选择代码:选择要处理的代码。
  2. 打开命令面板:按下 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)。
  3. 键入命令:键入“Roo Code”以筛选命令,然后选择相关的代码操作(例如,“Roo Code: Explain Code”)。该操作将应用于最合乎逻辑的上下文(通常是当前的活动聊天任务,如果存在的话)。
  4. 审查和批准:Roo Code 将在聊天面板中提出一个解决方案。审查提议的更改并批准或拒绝它们。

终端操作

Roo Code 还为终端输出提供了类似的操作:

  • 终端:添加到上下文:将选定的终端输出添加到你的聊天中
  • 终端:修复命令:要求 Roo Code 修复失败的终端命令
  • 终端:解释命令:要求 Roo Code 解释终端输出或命令

当你选择终端中的文本并右键单击时,这些操作可用。

禁用/启用代码操作

你可以通过 VSCode 设置控制代码操作:

启用/禁用代码操作

  • 设置roo-cline.enableCodeActions
  • 默认值:已启用
  • 描述:控制 Roo Code 快速修复选项是否出现在编辑器中

要访问此设置:

  1. 打开 VSCode 设置Ctrl/,Cmd+,
  2. 搜索 “enableCodeActions
  3. 切换复选框以启用或禁用

自定义代码操作提示

你可以通过修改 “提示” 选项卡中的 “支持提示” 来自定义用于每个代码操作的提示。这使你可以微调提供给 AI 模型的指令,并根据你的特定需求调整响应。

  1. 打开 “提示” 选项卡:点击 Roo Code 顶部菜单栏中的 Roo Code 图标。
  2. 找到 “支持提示”:你将看到支持提示,包括 “Enhance Prompt”、“Explain Code”、“Improve Code”和“Fix Code”。
  3. 编辑提示:修改你想要自定义的提示的文本区域中的文本。提示使用格式为 ${placeholder} 的占位符:
  • ${filePath} - 当前文件的路径
  • ${selectedText} - 当前选定的文本
  • ${diagnostics} - 任何错误或警告消息(用于“修复代码”) - 有关详细信息,请参阅诊断集成
  1. 点击“完成”:保存你的更改。

示例提示模板

Please explain the following code from ${filePath}:

${selectedText}

通过使用 Roo Code 的代码操作,你可以直接在你的编码工作流中快速获得 AI 驱动的帮助。这可以为你节省时间并帮助你编写更好的代码。

相关功能

  • 诊断集成 - 了解 Roo Code 如何与 VSCode 的问题面板集成
  • 上下文提及 - 发现向 Roo Code 提供上下文的其他方法