@<路径>
在提示词输入框中直接打开一个交互式浮层,用于选择文件路径。
在提示输入框中输入 @,会弹出“Interactive Path Suggestion”浮层:它会搜索工作区中的文件路径,并把选中的绝对路径直接插入到提示中。根据 CLI 文档的最佳实践建议,这类上下文锚点的作用是更精确地界定代理的推理范围、避免不必要的 token 开销,而不是手动敲入路径或依赖自由文本识别。尤其是在包含多个同名文件(例如多个 index.ts)的大型仓库中,插入的绝对路径能确保代理准确引用到目标文件。
在 1.0.6 版之前,只有当 @ 前面紧邻空格时才会触发提示;自 1.0.6 版修复后,@ 会无条件触发,即使紧跟在左括号 ( 之后或位于单词中间也一样。该浮层只是对文本输入的附加功能:它不会执行任何操作,也不会替换提示中已有的文本。
✅ 什么时候用？
精确引用某个文件,而不必手动输入路径
输入 @src/auth/,在浮层中导航到对应的文件
在提问时直接把某个文件作为上下文提供给代理
给我解释一下 @src/utils/formatter.ts 里的逻辑
⛔ 什么时候不该用？
想直接执行一条终端命令
@ 只会把文件路径插入到提示中,不会执行任何操作。
更好的选择: 在行首使用 ! 来直接执行终端命令
想触发一个斜杠命令
@ 只会打开路径浮层,不会打开命令列表。
更好的选择: 在行首输入 /,打开斜杠命令菜单
来源
- Antigravity CLI 文档：Best Practices ↗ antigravity.google
- Antigravity CLI 文档：Using the CLI ↗ antigravity.google