代码操作
代码操作通过 VSCode 的灯泡(快速修复)系统,在代码编辑器中直接提供 Roo Code AI 辅助功能。这一上下文感知功能会自动检测相关代码场景,并提供相应的 AI 驱动操作,无需切换到聊天界面。
什么是代码操作?
代码操作以灯泡图标(💡)的形式出现在编辑器的装订线区域(行号左侧)。也可通过右键上下文菜单或键盘快捷键访问。在以下情况下触发:
- 选中一段代码范围。
- 光标位于有问题的行(错误、警告或提示)。
- 通过命令调用。
点击灯泡图标、右键选择 "Roo Code",或使用键盘快捷键(默认为 Ctrl+. 或 macOS 上的 Cmd+.),将显示可用操作的菜单。
Roo Code 的代码操作
Roo Code 提供 5 种代码操作,但其可用性因上下文而异:
上下文菜单操作(右键)
- 添加到上下文:快速将选中的代码添加到与 Roo 的聊天中,包含文件名和行号,让 Roo 知道代码的确切来源。它在菜单中排在第一位,便于访问。
- 解释代码:请求 Roo Code 解释选中的代码。
- 改进代码:请求 Roo Code 对选中的代码提出改进建议。
其他操作
- 修复代码:通过灯泡菜单和命令面板(而非右键菜单)提供。请求 Roo Code 修复选中代码中的问题。
- 新建任务:使用选中的代码创建新任务。通过命令面板提供。
上下文感知操作
灯泡菜单会根据代码的当前状态智能显示不同的操作:
对于有问题的代码(当 VSCode 显示红色/黄色波浪线时):
- 修复代码 - 获得逐步指导以解决特定错误或警告
- 添加到上下文 - 将有问题的代码添加到 Roo 的上下文中进行讨论
对于干净的代码(无诊断问题):
- 解释代码 - 获得代码的详细解释
- 改进代码 - 获得优化建议和最佳实践
- 添加到上下文 - 将代码添加到 Roo 的上下文中进行进一步工作
有关诊断如何与代码操作集成的更多详细信息,请参阅 诊断集成。
添加到上下文深度解析
添加到上下文 操作在代码操作菜单中排在第一位,因此您可以快速将代码片段添加到对话中。使用它时,Roo Code 会包含文件名和行号以及代码。
这有助于 Roo 了解代码在项目中的确切上下文,从而提供更相关和准确的辅助。
提示:使用 macOS 的 Cmd+K Cmd+A 或 Windows/Linux 的 Ctrl+K Ctrl+A 快速将选区添加到上下文。参阅 键盘快捷键。
示例聊天输入:
你能解释一下这个函数吗?
@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: 解释代码")。操作将在最合理的上下文中应用(通常是当前活动的聊天任务,如果存在的话)。
- 审查并批准:Roo Code 将在聊天面板中提出解决方案。审查建议的更改并批准或拒绝。
终端操作
Roo Code 还为终端输出提供类似的操作:
- 终端:添加到上下文:将选中的终端输出添加到聊天中
- 终端:修复命令:请求 Roo Code 修复失败的终端命令
- 终端:解释命令:请求 Roo Code 解释终端输出或命令
这些操作在终端中选中文本并右键点击时可用。
禁用/启用代码操作
您可以通过 VSCode 设置控制代码操作:
启用/禁用代码操作
- 设置:
roo-cline.enableCodeActions - 默认:启用
- 描述:控制 Roo Code 快速修复选项是否出现在编辑器中
访问此设置的方法:
- 打开 VSCode 设置(
Ctrl/Cmd + ,) - 搜索 "enableCodeActions"
- 切换复选框以启用或禁用
自定义代码操作提示
您可以通过修改 提示 选项卡中的 "支持提示" 来自定义每种代码操作使用的提示。这允许您微调给 AI 模型的指令,并根据您的特定需求定制响应。
- 打开提示选项卡:点击 Roo Code 顶部菜单栏中的 图标。
- 找到 "支持提示":您将看到支持提示,包括 "增强提示"、"解释代码"、"改进代码" 和 "修复代码"。
- 编辑提示:修改要自定义的提示的文本区域中的文本。提示使用
${placeholder}格式的占位符:${filePath}- 当前文件的路径${selectedText}- 当前选中的文本${diagnostics}- 任何错误或警告消息(用于修复代码)- 详细信息请参阅 诊断集成
- 点击 "完成":保存您的更改。
示例提示模板
请解释以下来自 ${filePath} 的代码:
${selectedText}
通过使用 Roo Code 的代码操作,您可以直接在编码工作流中快速获得 AI 驱动的辅助。这可以节省时间并帮助您编写更好的代码。