文件引用与 Shell 输入

交互输入框除自然语言外，还识别 /、@ 和 !。Slash commands 管理 CLI；@path 提供文件上下文；! 直接进入 Shell 操作。输入前先确认当前模式，尤其是在粘贴命令时。

引用文件或目录

@src/parser.ts Explain how this parser handles invalid input.
@src/components/ Summarize the components in this directory.
What does this document describe? @README.md

文件路径注入该文件内容；目录路径尝试读取目录及子目录中的文件。路径含空格时按命令参考使用反斜杠，例如 @My\ Documents/file.txt。单独的 @ 会作为普通文本发送。

命令参考说明该过程由 read_many_files 加载内容，并显示相关工具状态。它主要面向文本文件，二进制或很大的文件可能跳过或截断；以实际加载提示为准。自定义命令 @{...} 的专页另有多模态说明，参见文件注入。

核对过滤和错误

默认加载会考虑 Git 忽略规则，行为由 context.fileFiltering 控制。不要据此假定每一个 .env 都必然被过滤；检查项目的忽略规则与过滤设置。

路径不存在、无读取权限或读取失败时，CLI 会报告错误。请求可能停止，也可能在没有该文件内容的情况下继续发送；回答出现不等于文件加载成功。

执行一次 Shell 命令

!git status

CLI 执行命令并显示输出或错误，随后返回正常交互。命令参考列出 Linux/macOS 使用 Bash，Windows 使用 powershell.exe -NoProfile -Command，Windows 可受 ComSpec 覆盖影响。更完整的工具执行说明见Shell 工具。

切换 Shell 模式

单独输入 ! 切换 Shell 模式。界面颜色和模式指示会变化，此时输入直接按 Shell 命令解释；再次切换后恢复普通 Gemini CLI 输入。

Shell 模式具有直接在终端执行命令的实际权限和影响，不是请模型解释一段命令。CLI 为通过 ! 启动的子进程设置 GEMINI_CLI=1，便于脚本识别运行环境。