---
url: /antigravity/cli-features.md
description: 了解 Antigravity CLI 的核心功能，包括插件系统、终端沙箱安全机制、斜杠命令、以及异步子 Agent。
---

# Antigravity CLI 功能特性 (Antigravity CLI Features)

## 插件系统 (Plugins)

### 插件如何工作

插件是命名空间的捆绑包，可以将技能 (skills)、Agent (agents)、规则 (rules)、MCP 服务端和钩子 (hooks) 作为一个单一的部署单元进行打包。

当您安装插件时，CLI 会将文件存放在您主目录下的 `~/.gemini/antigravity-cli/plugins/<plugin_name>/` 中。Antigravity Agent 会自动发现并加载这些已存放的自定义项。

```
~/.gemini/antigravity-cli/
├── plugins/
│   └── <plugin_name>/
│       ├── plugin.json         # 必需的标记文件
│       ├── mcp_config.json     # 可选的 MCP 服务端定义
│       ├── hooks.json          # 可选的事件钩子定义
│       ├── skills/             # 可选的技能包
│       ├── agents/             # 可选的子 Agent
│       └── rules/              # 可选的规则
└── import_manifest.json        # 跟踪清单
```

### 访问插件组件

一旦存放并加载完成，您就可以使用斜杠命令在 CLI 内部与插件组件进行交互。

## 终端沙箱 (Terminal Sandbox)

终端沙箱是一种轻量级的安全隔离机制，用于在 Agent 执行本地 Shell 命令时，保护您的主机系统免受潜在破坏性文件操作或未授权的外部网络请求的影响。

CLI 没有运行沉重的虚拟机或容器，而是利用原生操作系统特性（Linux 上的 nsjail、macOS 上的 sandbox-exec 以及 Windows 上的 AppContainer）来强制执行严格的容器化隔离边界，且没有任何启动开销。

### 配置

您可以在 `settings.json` 文件（位于 `~/.gemini/antigravity-cli/settings.json`）中配置沙箱行为：

```json
{
  "enableTerminalSandbox": true
}
```

* `enableTerminalSandbox` (布尔值，默认值: `false`)：在所有本地 Agent 进程上启用通用的执行容器化隔离屏障。

### 交互式审批

当 Agent 提议执行需要您确认的终端命令时，CLI 提示符会根据您的设置进行动态调整：

* **当启用沙箱时**：确认提示将包含一个特定选项 `Yes, and run without sandbox`（确认，且不在沙箱限制下运行），以便您需要为单个受信任的命令临时绕过隔离边界。
* **当禁用沙箱时**：提示将包含一个选项 `Yes, and run in sandbox`（确认，且在沙箱中运行），如果您想强制在安全边界内执行特定的、有潜在风险的命令。

## CLI 斜杠命令参考 (CLI Slash Commands Reference)

Antigravity CLI 支持在提示框中直接输入各种斜杠命令，用以管理对话、配置设置以及检查 Agent 的能力。

### 核心斜杠命令

| 命令 | 类别 | 用途 |
| :--- | :--- | :--- |
| `/resume` (别名 `/switch`) | 对话 | 打开对话选择器以恢复或切换会话。 |
| `/rewind` (别名 `/undo`) | 对话 | 将对话历史回滚到先前的检查点。 |
| `/rename <name>` | 对话 | 重命名当前活跃的对话线程，以便于跟踪。 |
| `/permissions` | 配置 | 选择 Agent 自主权级别 (`request-review`、`always-proceed` 或 `strict`)。 |
| `/model` | 配置 | 选择默认的推理模型（跨会话持久化）。 |
| `/keybindings` | 配置 | 打开交互式快捷键编辑器。 |
| `/statusline` | 配置 | 自定义 CLI 状态栏中显示的实时指示器。 |
| `/tasks` | 工具与监控 | 监控、查看日志或终止活跃的后台任务。 |
| `/skills` | 工具与监控 | 浏览本地和全局封装的 Agent 工作流。 |
| `/mcp` | 工具与监控 | 打开面板来配置和管理模型上下文协议 (Model Context Protocol) 服务端。 |
| `/open <path>` | 实用工具 | 立即在您偏好的外部编辑器中打开文件。 |
| `/usage` | 实用工具 | 在终端内打开内嵌的交互式帮助手册。 |
| `/logout` | 账户 | 退出您的 Google 会话并清除缓存的凭据。 |

### 通过 `settings.json` 进行高级自定义

对于高级用户，有几个斜杠命令支持通过您的 `~/.gemini/antigravity-cli/settings.json` 配置进行深度自定义：

* **细粒度权限**：除了全局级别之外，您还可以定义特定的允许/拒绝命令：
  ```json
  "permissions": {  
    "allow": ["command(git)", "command(npm test)"],  
    "deny": ["command(rm -rf)"]  
  }  
  ```
* **自定义状态栏和窗口标题**：您可以将实时 Agent 元数据（包含 CWD、当前模型、Token 使用情况、状态等的 JSON 格式）直接通过管道传输到您自己的自定义 Shell 脚本中，以生成动态状态栏或终端窗口标题。

## Antigravity CLI 中的子 Agent (Subagents in Antigravity CLI)

Antigravity CLI 包含一个异步子 Agent 框架，允许主 Agent 委派并行工作、执行后台研究并运行系统测试，而不会阻塞您当前活跃的对话。

### 什么是子 Agent？

子 Agent 是独立的、并发运行的 Agent 会话，旨在与主对话并行处理特定的后台任务。

* **目的**：主 Agent 会自动生成子 Agent 以执行后台操作，例如查找文档、运行构建或验证修复方案。
* **能力**：子 Agent 拥有对工具的完整访问权限，例如代码搜索、文件编辑、终端命令和网页搜索，以完成分配给它们的任务。
  主 Agent 决定子 Agent 可以获得哪些工具和权限，包括它们是否可以使用 MCP 工具以及是否可以写入文件。

### 管理 Agent：`/agents` 面板

Antigravity CLI 提供了一个交互式终端 UI，用于查看、管理和批准运行中的子 Agent 的操作。

* **访问**：在提示符中输入 `/agents` 即可打开子 Agent 面板。
* **概述**：该面板显示了活跃和已完成的子 Agent 列表，包括表面层面的详细信息，例如它们的状态（运行中、已完成、已终止等）以及当前执行的步骤。

> \[!INFO]
> 从面板中选择一个子 Agent 将打开全屏详细视图。此视图显示该子 Agent 的完整对话，包括其步骤、思考和工具执行日志。

### 工具确认与审批

当子 Agent 想要执行需要用户权限的工具（例如运行本地命令或写入文件）时，它会呈报该请求。您可以通过以下两种方式管理审批：

#### 详细视图审批

子 Agent 详细视图包含一个交互区域，显示所有待处理的审批，您可以在其中选择性地批准或拒绝请求。

> \[!TIP]
> 提示：使用快捷键 `ctrl+j` 可以从主对话直接“传送”到等待您审批的下一个子 Agent 的详细视图。

#### 快速通道警报 (Fast Path Alerts)

为了保持您的专注，当子 Agent 请求权限时，Antigravity CLI 会在您的提示框正上方直接显示快速通道警报。

> \[!TIP]
> 提示：您可以使用 `ctrl+k` 立即批准待处理的子 Agent 权限，而无需切换出主对话。