工具如何工作
了解 Roo Code 如何使用工具与您的系统交互。了解文件操作、命令执行、浏览器控制和批准工作流程。
工具如何运作
Roo Code 使用工具与您的代码和环境进行交互。这些专门的助手可以执行特定操作，例如读取文件、进行编辑、运行命令或搜索您的代码库。工具可以自动执行常见的开发任务，而无需手动执行。
工具工作流程
用自然语言描述您想要完成的任务，Roo Code 将会：
- 根据您的请求选择合适的工具
- 展示带有其参数的工具供您审查
- 执行已批准的工具并向您展示结果
- 继续此过程，直到您的任务完成
工具类别
| 类别 | 用途 | 工具名称 |
|---|---|---|
| 读取 | 访问文件内容和代码结构 | read_file, search_files, list_files, list_code_definition_names |
| 编辑 | 创建或修改文件和代码 | write_to_file, apply_diff |
| 执行 | 运行命令和执行系统操作 | execute_command |
| 浏览器 | 与网页内容交互 | browser_action |
| 工作流 | 管理任务流程和上下文 | ask_followup_question, attempt_completion, switch_mode, new_task |
示例：使用工具
以下是典型的工具交互如何工作：
工具批准界面显示 “保存”/“拒绝” 按钮和 “自动批准” 选项。
- 用户：Create a file named
greeting.jsthat logs a greeting message - Roo Code：（提醒使用
write_to_file工具，如上图所示）
<write_to_file>
<path>greeting.js</path>
<content>
function greet(name) {
console.log(`Hello, ${name}!`);
}
greet('World');
</content>
<line_count>5</line_count>
</write_to_file>
- 用户：（在界面中点击 “保存”）
- Roo Code：（确认文件创建）
工具安全和批准
每次使用工具都需要您的明确批准。当 Roo 提出一个工具时，您会看到：
- 一个 “保存” 按钮，用于批准并执行该工具
- 一个 “拒绝” 按钮，用于拒绝所提议的工具
- 一个可选的 “自动批准” 设置，用于受信任的操作
这种安全机制可确保您始终控制哪些文件被修改、执行哪些命令以及如何更改您的代码库。在保存工具提案之前，请务必仔细审查。
核心工具参考
| 工具名称 | 描述 | 类别 |
|---|---|---|
read_file | 读取带行号的文件内容 | 读取 |
search_files | 在文件中搜索文本或正则表达式模式 | 读取 |
list_files | 列出指定位置的文件和目录 | 读取 |
list_code_definition_names | 列出代码定义，如类和函数 | 读取 |
write_to_file | 创建新文件或覆盖现有文件 | 编辑 |
apply_diff | 对文件的特定部分进行精确更改 | 编辑 |
execute_command | 在 VS Code 终端中运行命令 | 执行 |
browser_action | 在无头浏览器中执行操作 | 浏览器 |
ask_followup_question | 向您提出一个澄清问题 | 工作流 |
attempt_completion | 指示任务已完成 | 工作流 |
switch_mode | 切换到不同的操作模式 | 工作流 |
new_task | 创建一个具有特定起始模式的新子任务 | 工作流 |
了解有关工具的更多信息
有关每个工具的更详细信息，包括完整的参数参考和高级使用模式，请参阅 工具使用概述 文档。