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