主题
Gemini CLI 工具
Gemini CLI 包含内置工具，Gemini 模型使用这些工具与你的本地环境交互、访问信息和执行操作。这些工具增强了 CLI 的功能，使其能够超越文本生成并协助完成各种任务。
Gemini CLI 工具概述
在 Gemini CLI 的上下文中，工具是 Gemini 模型可以请求执行的特定函数或模块。例如，如果你要求 Gemini "总结 my_document.txt 的内容"，模型可能会识别出需要读取该文件，并请求执行 read_file 工具。
核心组件（packages/core）管理这些工具，向 Gemini 模型呈现它们的定义（模式），在请求时执行它们，并将结果返回给模型以进一步处理成面向用户的响应。
这些工具提供以下功能：
- 访问本地信息： 工具允许 Gemini 访问你的本地文件系统、读取文件内容、列出目录等。
- 执行命令： 使用
run_shell_command等工具，Gemini 可以运行 shell 命令（具有适当的安全措施和用户确认）。 - 与网络交互： 工具可以从 URL 获取内容。
- 执行操作： 工具可以修改文件、写入新文件或在你的系统上执行其他操作（同样，通常有安全措施）。
- 基于响应： 通过使用工具获取实时或特定的本地数据，Gemini 的响应可以更准确、更相关，并基于你的实际上下文。
如何使用 Gemini CLI 工具
要使用 Gemini CLI 工具，向 Gemini CLI 提供提示。过程如下：
- 你向 Gemini CLI 提供提示。
- CLI 将提示发送到核心。
- 核心连同你的提示和对话历史，将可用工具列表及其描述/模式发送到 Gemini API。
- Gemini 模型分析你的请求。如果它确定需要工具，其响应将包括使用特定参数执行特定工具的请求。
- 核心接收此工具请求，验证它，并（通常在用户确认敏感操作后）执行工具。
- 工具的输出被发送回 Gemini 模型。
- Gemini 模型使用工具的输出来制定其最终答案，然后通过核心发送回 CLI 并显示给你。
你通常会在 CLI 中看到消息，指示何时调用工具以及它是成功还是失败。
安全和确认
许多工具，特别是那些可以修改你的文件系统或执行命令的工具（write_file、edit、run_shell_command），在设计时考虑了安全性。Gemini CLI 通常会：
- 需要确认： 在执行潜在敏感操作之前提示你，显示即将执行的操作。
- 使用沙盒： 所有工具都受沙盒强制执行的限制（参见 Gemini CLI 中的沙盒）。这意味着在沙盒中操作时，你希望使用的任何工具（包括 MCP 服务器）必须在沙盒环境_内部_可用。
在允许工具继续之前，始终仔细查看确认提示非常重要。
了解更多关于 Gemini CLI 工具的信息
Gemini CLI 的内置工具可以大致分类如下：
- 文件系统工具： 用于与文件和目录交互（读取、写入、列出、搜索等）。
- Shell 工具（
run_shell_command）： 用于执行 shell 命令。 - Web 获取工具（
web_fetch）： 用于从 URL 检索内容。 - Web 搜索工具（
google_web_search）： 用于搜索网络。 - 记忆工具（
save_memory）： 用于跨会话保存和回忆信息。 - 待办事项工具（
write_todos）： 用于管理复杂请求的子任务。
此外，这些工具还包含：