代码操作
代码操作通过 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. 从灯泡 (💡)
- 选择代码:选择要处理的代码。你可以选择单行、多行或整个代码块。
- 寻找灯泡:在选定代码旁边的边槽(或有错误/警告的行)中会出现一个灯泡图标。
- 点击灯泡:点击灯泡图标打开代码操作菜单。
- 选择操作:从菜单中选择所需的 Roo Code 操作。
- 审查和批准:Roo Code 将在聊天面板中提出一个解决方案。审查提议的更改并批准或拒绝它们。
2. 从右键上下文菜单
- 选择代码:选择要处理的代码。
- 右键单击:右键单击选定的代码以打开上下文菜单。
- 选择“Roo Code”:从上下文菜单中选择“Roo Code”选项。将出现一个子菜单,其中包含可用的 Roo Code 操作。
- 选择操作:从子菜单中选择所需的操作。
- 审查和批准:Roo Code 将在聊天面板中提出一个解决方案。审查提议的更改并批准或拒绝它们。
3. 从命令面板
- 选择代码:选择要处理的代码。
- 打开命令面板:按下
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)。 - 键入命令:键入“Roo Code”以筛选命令,然后选择相关的代码操作(例如,“Roo Code: Explain Code”)。该操作将应用于最合乎逻辑的上下文(通常是当前的活动聊天任务,如果存在的话)。
- 审查和批准:Roo Code 将在聊天面板中提出一个解决方案。审查提议的更改并批准或拒绝它们。
终端操作
Roo Code 还为终端输出提供了类似的操作:
- 终端:添加到上下文:将选定的终端输出添加到你的聊天中
- 终端:修复命令:要求 Roo Code 修复失败的终端命令
- 终端:解释命令:要求 Roo Code 解释终端输出或命令
当你选择终端中的文本并右键单击时,这些操作可用。
禁用/启用代码操作
你可以通过 VSCode 设置控制代码操作:
启用/禁用代码操作
- 设置:
roo-cline.enableCodeActions - 默认值:已启用
- 描述:控制 Roo Code 快速修复选项是否出现在编辑器中
要访问此设置:
- 打开 VSCode 设置(
Ctrl/,或Cmd+,) - 搜索 “
enableCodeActions” - 切换复选框以启用或禁用
自定义代码操作提示
你可以通过修改 “提示” 选项卡中的 “支持提示” 来自定义用于每个代码操作的提示。这使你可以微调提供给 AI 模型的指令,并根据你的特定需求调整响应。
- 打开 “提示” 选项卡:点击 Roo Code 顶部菜单栏中的 Roo Code 图标。
- 找到 “支持提示”:你将看到支持提示,包括 “
Enhance Prompt”、“Explain Code”、“Improve Code”和“Fix Code”。 - 编辑提示:修改你想要自定义的提示的文本区域中的文本。提示使用格式为
${placeholder}的占位符:
${filePath}- 当前文件的路径${selectedText}- 当前选定的文本${diagnostics}- 任何错误或警告消息(用于“修复代码”) - 有关详细信息,请参阅诊断集成。
- 点击“完成”:保存你的更改。
示例提示模板
Please explain the following code from ${filePath}:
${selectedText}
通过使用 Roo Code 的代码操作,你可以直接在你的编码工作流中快速获得 AI 驱动的帮助。这可以为你节省时间并帮助你编写更好的代码。