亲身体验 Antigravity CLI

1. 简介

在此 Codelab 中，您将了解 Antigravity CLI，这是 Antigravity 的轻量级终端用户界面 (TUI)。它可将与 Antigravity 2.0 相同的核心智能体功能（例如多步推理、多文件编辑、工具调用和对话历史记录）直接带到您的终端。

学习内容

1. 安装和配置 Antigrabity CLI
2. 了解 Antigravity CLI 的基本用法
3. 探索 Antigravity CLI 的几个应用场景

所需条件

您需要具备以下条件：

• Chrome 网络浏览器
• Gmail 账号

本 Codelab 适合不同水平的用户和开发者（包括新手）。Codelab 中的用例分为开发者任务和非开发者任务。开发者用例演示了如何使用 Antigravity CLI 编写代码，以及如何使用 GitHub 代码库执行常见的开发任务，例如代码说明/理解、生成文档、修复问题等。建议您完成 Codelab 中的这些用例。最后还有一个可选部分，其中介绍了几个非开发者日常任务。

2. 准备工作

创建项目

1. 在 Google Cloud Console 的项目选择器页面上，选择或创建一个 Google Cloud 项目。
2. 确保您的 Cloud 项目已启用结算功能。了解如何检查项目是否已启用结算功能。
3. 您将使用 Cloud Shell，这是一个在 Google Cloud 中运行的命令行环境，它预加载了 bq。点击 Google Cloud 控制台顶部的“激活 Cloud Shell”。

4. 连接到 Cloud Shell 后，您可以使用以下命令检查自己是否已通过身份验证，以及项目是否已设置为您的项目 ID：

gcloud auth list

5. 在 Cloud Shell 中运行以下命令，以确认 gcloud 命令了解您的项目。

gcloud config list project

6. 如果项目未设置，请使用以下命令进行设置：

gcloud config set project <YOUR_PROJECT_ID>

3. 安装

在设置并运行 Antigravity CLI 之前，我们先创建一个文件夹，作为我们所有项目的起始主文件夹。这是 Antigravity CLI 的起始工作目录，不过它也会根据需要引用系统上的其他一些文件夹，您稍后会用到这些文件夹。

继续操作，创建一个示例文件夹 (agy-cli-projects)，然后通过以下命令进入该文件夹。如果您希望使用其他文件夹名称，请自行更改。

mkdir agy-cli-projects

我们来导航到该文件夹：

cd agy-cli-projects

安装过程非常简单，并且二进制文件可在各种主要操作系统中使用。我直接从安装文档中提取了要在终端中运行的命令：

macOS | Linux

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows PowerShell

irm https://antigravity.google/cli/install.ps1 | iex

Windows CMD

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

此命令应会在您的系统和路径中设置并安装 Antigravity CLI (agy)。

在某些情况下，如果安装程序无法将二进制文件（agy 到 PATH）添加到 PATH，它会说明这一点。例如，以下是计算机上的示例输出，其中安装程序无法将二进制文件添加到 PATH，并建议了相应操作。

% curl -fsSL https://antigravity.google/cli/install.sh | bash
⠋ Detecting system environment...
✓ Platform detected: darwin_arm64
⠋ Querying release repository...
✓ Latest available version: 1.0.1
⠋ Downloading release package...
✓ Download complete and checksum verified.
⠋ Extracting binary from archive...
⠋ Configuring shell environment...
I0523 11:44:14.012088 76528 installer.go:27] Running Antigravity CLI setup...
Warning: /Users/neilirani/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:
 echo 'export PATH="/Users/yourusername/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
✅ Antigravity CLI binary placed successfully at /Users/yourusername/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.

只需通过以下命令查看 Antigravity CLI 的版本（显示的为撰写本 Codelab 时的版本）：

$ agy --version
1.0.5

首次启动 Antigravity CLI 时，系统会要求您登录。启动 agy，它应显示类似如下的内容：

    ▄▀▀▄
   ▀▀▀▀▀▀
  ▀▀▀▀▀▀▀▀
 ▄▀▀    ▀▀▄
▄▀▀      ▀▀▄

Welcome to the Antigravity CLI. You are currently not signed in.

Select login method:
> 1. Google OAuth
  2. Use a Google Cloud project

[Use arrow keys to navigate, Enter to select]

暂时使用您的个人账号。选择 1. Google OAuth，然后按 Enter 键。系统会启动浏览器，您可以使用自己的 Google 账号登录。成功完成身份验证和授权后，系统会要求您复制一个代码。请返回 Antigravity CLI 终端并粘贴该代码。

登录成功后，会出现以下情况：

1. 首先，系统会询问您希望为 Antigravity CLI 选择的色彩主题，如下所示。选择您喜欢的。
2. 接下来，您需要接受几项服务条款。请接受这些条款。

最后，最重要的一点是授予权限，表明您信任相应文件夹，如下所示：

Accessing workspace:

/Users/yourusername/agy-cli-projects

Do you trust the contents of this project?

Antigravity CLI requires permission to read, edit, and execute files here.

> Yes, I trust this folder
 No, exit

 ↑/↓ Navigate · enter Confirm

通常，在您启动 Antigravity CLI 的任何新文件夹中，您都会看到此文件。我们将在本系列的后续内容中详细介绍这一点，但现在，请继续并点击是，我信任此文件夹。

恭喜！您现在已准备就绪，Antigravity CLI 正等待您的提示。

4. 我们与 Antigravity CLI 的首次互动

我们来开始使用 Antigravity CLI 吧。请输入您的首次查询，如下所示：

Give me a famous quote on Artificial Intelligence and who said that?

系统应会显示如下回答：

● WebSearch(famous quotes on Artificial Intelligence) (ctrl+o to expand)
  Here is one of the most famous quotes on Artificial Intelligence:                                                  
                                                                                                                     
  │ "AI is the new electricity."                                                                                     
  │ — Andrew Ng (Co-founder of Coursera and Google Brain, Adjunct Professor at Stanford University)                  
                                                                                                                     
  Another widely cited perspective on the potential risks of AI is:                                                  
                                                                                                                     
  │ "The development of full artificial intelligence could spell the end of the human race. It would take off on its 
  │ own, and re-design itself at an ever-increasing rate."                                                           
  │ — Stephen Hawking         
  

您应该会注意到，Antigravity 使用了其内部工具 WebSearch 来获取引文。

除了在此处提供提示之外，Antigravity CLI 还支持哪些各种命令？您可以输入 /help（正斜杠）来查看各种命令和键盘快捷键。撰写本文时，部分命令如下所示：

Antigravity CLI   general    commands    shortcuts   (←/→ or tab to cycle)
Available Commands
> /add-dir                        Add a directory to the workspace
  /agents                         List available custom agents
  /artifact                       View and review artifacts
  /btw                            Ask a side question without interrupting the current task
  /changelog                      Show release notes and changes
  /clear (new)                    Clear conversation and start a new one
  /config (settings)              Open settings panel
  /context                        Visualize current context usage
  /copy                           Copy the last planner response to the clipboard (may require allowing clipboard ac...
  /credits                        Show remaining G1 credits and purchase link
  /diff                           View uncommitted changes and per-turn diffs
  /exit (quit)                    Exit the CLI
  /fast                           Agent will execute tasks directly. Use for simple tasks that can be completed faster
  /feedback                       Submit qualitative feedback to improve the agent
  /fork (branch)                  Create a branch of the current conversation at this point
  /help                           Show available commands and keybindings
  /hooks                          Manage hook configurations for tool events
  /keybindings                    Set custom keybindings
  /logout                         Log out
  /mcp                            Manage MCP servers
  /model                          Set a model
  /open                           Open a file or view opened/edited files
  /permissions                    Manage tool permissions
  /planning                       Agent can plan before executing tasks. Use for deep research, complex tasks, or co...

<MORE_COMMANDS>

我们现在退出 Antigravity CLI。您可以通过 /quit 命令退出，也可以在交互式 Antigravity CLI 终端会话中按两次 ctrl+d。

5. Antigravity CLI - 一些内务管理命令

确保 Antigravity CLI 已启动，并且正在等待您的命令。

请注意它使用的模型，其名称将显示在右下角。首先，最好了解您需要进行的大部分自定义设置都可以通过 /config 或 /settings 命令完成。

配置 / 设置

继续操作并调用 /config 命令。这样会显示 Antigravity 的各个区域，您可以根据自己的偏好进行自定义。包括配色方案、工具权限、遥测设置等。

Settings
  Search:  
          ────────────────────
> Animation Speed      medium
  Artifact Review      asks for review
  Color Scheme         dark
  Editor               auto ($EDITOR)
  Enable Telemetry     on
  Non-Workspace Access off
  Notifications        off
  Rendering Mode       native terminal (inline)
  Sandbox Mode         off
  Show Feedback Survey on
  Show Tips            on
  Tool Permission      request-review
  Use AI Credits       off
  Verbosity            high

例如，“配色方案”会显示以下选项，我可以从中选择自己喜欢的配色方案：

 Color Scheme                   ╭─────────────────────────────────────────────────────────────╮
    terminal                     │   
    light                        │                                                             
    solarized light              │                                         
    colorblind-friendly light    │                                                             
  > dark (current)               │                                            
    solarized dark               │                                                           
    colorblind-friendly dark     │                                      
    tokyo night      

settings.json

配置设置需要存储在某个位置，对吧？所有这些信息都会存储在 ~/.gemini/antigravity-cli/settings.json 文件中。示例 如下所示：

{
      "colorScheme": "dark",
      "model": "Gemini 3.5 Flash (High)",
      "statusLine": {
        "type": "",
        "command": "",
        "enabled": true
      },
      "trustedWorkspaces": [
        "/Users/romin/antigravity-cli-projects",
        "/Users/romin/agy-cli-projects"
      ]
    }

您可以看到，我选择了 colorScheme，以及我启动 Antigravity CLI 并同意信任文件夹的模型和各种文件夹。

注意：您也可以直接修改 settings.json，然后重启 Antigravity CLI，这是查看更改的最佳做法。但请务必确保设置正确，否则系统会在启动时显示错误。如果您不习惯直接修改该文件，建议您使用 Antigravity CLI 中的 /settings 或 /config 命令来处理该文件。

工具权限

需要了解的一项重要设置是工具权限。此设置用于控制终端命令是否需要在运行前获得您的批准。您可以通过 /config 命令访问此页面。

 Tool Permission
  > request-review (current)
    proceed-in-sandbox
    always-proceed
    strict

默认情况下，该值设置为 request-review。我们来详细了解一下。在 Antigravity 中，工具权限设置可控制安全性（保护宿主系统免遭意外更改）与速度（智能体在无需您输入的情况下自主工作的程度）之间的平衡。我们来了解一下相关选项：

request-review（当前默认值）

在此模式下，智能体会被视为协作伙伴，在执行任何可能会影响预先批准范围之外的系统或项目文件的操作之前，它会先进行确认。每当代理尝试运行终端命令、执行文件操作（例如写入/删除）或调用尚未预先批准权限的外部服务时，执行都会暂停。系统会提示用户批准或拒绝相应操作。

proceed-in-sandbox

在此模式下，代理可以自动执行终端命令，但只能在安全、隔离的容器内执行。代理可以在不提示您的情况下运行命令，但这些命令会在虚拟化沙盒（例如轻量级容器）中执行。它们无法修改实际宿主机的文件系统或访问本地网络。

always-proceed

这是全自动驾驶模式，可为智能体提供最高速度和能力。代理会被授予在宿主机上直接运行命令和写入文件的完整权限。系统绝不会提示您进行确认。

严格

这是一种零信任高安全模式。代理的功能仅限于执行读取工具。所有非读取工具都需要提示用户采取行动。

6. Antigravity CLI - 命令参数

启动 Antigravity CLI 时，您可以提供一些命令行参数。如需获取完整的选项列表，您可以使用 --help，如下所示。

agy --help

这应该会显示所有可用的选项。示例商品详情如下所示：

$ agy --help
Usage of agy:
 --add-dir                       Add a directory to the workspace (repeatable) (default [])
 -c                              Short alias for --continue
 --continue                      Continue the most recent conversation
 --conversation                  Resume a previous conversation by ID
 --dangerously-skip-permissions  Auto-approve all tool permission requests without prompting
 -i                              Short alias for --prompt-interactive
 --log-file                      Override CLI log file path
 --model                         Model for the current CLI session
 -p                              Short alias for --print
 --print                         Run a single prompt non-interactively and print the response
 --print-timeout                 Timeout for print mode wait (default 5m0s)
 --prompt                        Alias for --print
 --prompt-interactive            Run an initial prompt interactively and continue the session
 --sandbox                       Run in a sandbox with terminal restrictions enabled

Available subcommands:
 changelog       Show changelog and release notes
 help            Show help for subcommands
 install         Configure environment paths and shell settings
 models          List available models
 plugin          Manage plugins (install, uninstall, list, enable, disable)
 plugins         Alias for plugin
 update          Update CLI

下面我们来看看其中的一些。

非互动模式（自主）

如果您感兴趣，也可以以非互动模式运行 Antigravity CLI。在非交互模式下，您直接向 Antigravity CLI 提供提示，它会立即做出回应，而不会打开 Antigravity CLI 交互式终端。如果您计划以自动方式在脚本或任何其他自动化流程中使用 Antigravity CLI，这个模式非常有用。

您可以使用 -p 参数向 Antigravity CLI 提供提示，如下所示：

agy -p "What is the gcloud command to deploy to Cloud Run"

这或许是快速获得答案的好方法，但请注意，您无法在对话中追问问题。

选择特定模型

第一种方法是让 Antigravity CLI 使用特定的 Gemini 模式。您可以使用 --model 参数来告知 Antigravity CLI 仅在其会话期间使用特定模型。这对于我们在上一部分中提到的非互动模式非常有用，在这种模式下，您可能希望启动多个 agy 会话，并针对特定任务使用特定模型。

不过，您首先需要了解 Antigravity CLI 支持哪些模型。您可以通过 models 子命令执行此操作，如下所示：

$ agy models
Gemini 3.5 Flash (Medium)
Gemini 3.5 Flash (High)
Gemini 3.5 Flash (Low)
Gemini 3.1 Pro (Low)
Gemini 3.1 Pro (High)
Claude Sonnet 4.6 (Thinking)
Claude Opus 4.6 (Thinking)

您可以使用上述任何模型名称来指定会话要使用的模型。您可以通过以下 --model 命令来指定：

$ agy --model "Claude Opus 4.6 (Thinking)"

Antigravity CLI 启动后，您可以通过 /model 命令查看您要求其使用的特定模型，也可以查看右下角显示的会话所用模型。

赶潮流就得冒点险

如果您喜欢冒险，可以寻找一个非常贴切的参数，名为 --dangerously-skip-permissions。此参数将自动批准所有工具权限，不会提示您请求权限。因此，请谨慎使用。

通过以下命令启动 Antigravity CLI：

agy --dangerously-skip-permissions

然后，给出以下提示。检查它是否未向我请求任何写入文件权限。

> get the latest news and write it in a file called news.txt. Then create another file that contains the summary of that file.

● ListDir(/Users/romin/agy-cli-projects)
● WebSearch(latest world news May 24 2026 news headlines) (ctrl+o to expand)

▸ Thought for 2s, 95 tokens
 Processing News Information

● Create(/Users/romin/agy-cli-projects/news.txt)
● Create(/Users/romin/agy-cli-projects/summary.txt) (ctrl+o to expand)

 I have fetched the latest world news headlines and created the requested files in your workspace:                                                                  
                                                                                                                                                                    
 1. news.txt: Contains the detailed news headlines for today (May 24, 2026), including topics on geopolitics (U.S.-Iran negotiations, Ukraine conflict), U.S. 
 security incidents, the Ebola outbreak in Central Africa, and the passing of NASCAR champion Kyle Busch.                                                           
 2. summary.txt: Contains a concise, structured summary of the major categories covered in the news file.                                                        

在本地且受您控制的情况下，此模式可能很有用，但仍需为意外情况做好准备，因此请谨慎使用。

7. Antigravity CLI - Shell 模式

现在是学习如何直接在 Antigravity CLI 中使用 Shell 模式的好时机。您可以在消息框中按 ! 进入 shell 模式。这将切换到 shell 模式。您可以再次按 ! 或按 ESC 键返回。

在 shell 模式下，您会看到提示的开头有 !，如下所示：

您可以直接使用 pwd 和 ls 等标准命令进行检查，如下所示。请注意，这些命令假定您使用的是 Linux 类型操作系统。如果您使用的是其他操作系统 (Windows)，请使用等效命令，例如 cd、dir 和 type。

8. 可尝试的应用场景

Antigravity CLI 可应用于各种用例，无论是开发者还是非开发者，都可以使用。下面列出了几种场景，您可以根据自己的兴趣尝试其中任何一种或全部场景。

在每种情况下，系统都会提供提示。您可以尝试在 Antigravity CLI 交互模式下执行此操作，以便更好地了解 Antigravity CLI 如何完成任务。

使用 Antigravity CLI 进行氛围编程 (vibe coding)

我们来使用 Antigravity CLI 进行氛围编程，编写应用代码。在此任务中，您将要求 Antigravity CLI 生成应用，然后将初始版本推送到 GitHub 代码库。

前提条件

如需执行本部分中的任务，您需要满足以下前提条件：

• Git
• Antigravity CLI
• Python 3 环境
• 设置 gh ( GitHub CLI 工具)。
• 熟悉 Git 基础知识，并具备一定的编程知识

我们将假设您已在所选的特定文件夹中启动 Antigravity CLI。在我们的示例中，我们已从初始主文件夹 agy-cli-projects 和其中的另一个文件夹 bq-releases-notes 启动 Antigravity CLI。

首先，输入初始提示。您可以将其视为应用的规范。请随意修改。请注意，在与 Antigravity CLI 的整个会话期间，它会要求您授予创建文件等权限。请务必授予所需的权限。

Please build a web application for me using Python Flask and plain vanilla HTML, JavaScript and CSS that fetches the BigQuery Release notes from (https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) and shows them to me. 

A simple refresh button with a spinner is good enough, anytime I'd like to refresh the details. 

I would also like the ability to take any specific update, select it and then Tweet about it.

接下来的几个提示和回答仅作为流程示例。Antigravity CLI 会制定一个计划，并询问您是否需要进行任何确认 / 澄清，或者是否继续。请按照说明操作。以下是我的示例对话串：

I will start by exploring the workspace to see if there is an existing structure or if this is a brand new project.                                                                   

● ListDir(/Users/romin/agy-cli-projects/bq-release-notes) (ctrl+o to expand)

 I will read the BigQuery release notes XML feed to understand its structure (Atom/RSS elements, entry/item elements, namespaces, dates, titles, content) so that we can parse it      
 correctly in the Python Flask backend.                                                                                                                                                

● ReadURL(https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) (ctrl+o to expand)

 I will view the fetched feed content saved locally to understand its format and structure.                                                                                            

● Read(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/.system_generated/steps/6/content.md) (ctrl+o to expand)

▸ Thought for 2s, 2.3k tokens
 Analyzing XML Feed Structure
 I will write the implementation plan detailing the architecture, design aesthetic, components, and verification steps for the BigQuery Release Notes Web Application. This plan will be
 written to the artifacts directory.                                                                                                                                                   

● Create(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/implementation_plan.md) (ctrl+o to expand)

 I have created the implementation_plan.md to outline the design and architecture of the BigQuery Release Notes Web Application.
                                                                                                                                                                                       
 Please review the plan, especially the approach for the Twitter Composer & Preview Card, and let me know if you approve or if there are any adjustments you'd like to make!           

                                                                                                                                                           1 artifact · /artifact to review

现在，让我们来了解一下 Antigravity 中的制品。工件是 Antigravity CLI 让我们及时了解实施方案、正在处理的任务列表、可验证的输出等的途径。这些文件是生成的，记录了 Antigravity 正在执行的工作、其计划、任务列表等。

完成此操作后，它会说“我已创建 implementation_plan.md 来概述 BigQuery 版本说明 Web 应用的设计和架构。请查看该方案，尤其是 Twitter 编辑器和预览卡片的实现方法，并告知我您是否批准该方案，或者是否需要进行任何调整！

您可以看到，右下角还显示有1 件制品待审核，在本例中，该制品是 implementation_plan.md。

输入命令 /artifact。系统会显示生成的制品 implementation_plan.md，您可以使用箭头键打开、批准、拒绝等。只需按 Escape 键返回到提示，即可在此处批准制品（如果您愿意）。

在本例中，我们将采用它生成的代码并批准它。这会启动下一组步骤，即开始实现（创建文件、运行一些命令等）。系统会提示您根据需要批准并授予执行权限。

在本例中，我们授予了该应用创建 Python 虚拟环境、通过 requirements.txt 安装依赖项等的权限。

在后台，它还根据实现方案必须执行的任务创建了一个 task.md 文件，并在完成各个任务时将其勾选。完成后，它会通知您，然后您可以在浏览器中查看应用。以下是它为我们生成的内容：

我们现在可以停止了。这个示例旨在演示和检查它在简单要求下的功能。

（可选）将更改推送到 GitHub 代码库

如果您不想将我们创建的活动网站推送到 GitHub，可以忽略此部分，直接进入下一部分。

首先，我们来创建一个 .gitignore 文件，您可以借助 Antigravity CLI。

Create a .gitignore file for this project.

您的下一步是向 Antigravity CLI 发出指令，要求将此代码库推送到我们的 GitHub 账号下，这应该会使用预期在您的机器上可用并已配置 / 设置的 GitHub 辅助程序 (gh)。GitHub MCP 服务器工具在后台运行。

输入类似于以下内容的提示：

Great! I would now like to push all of this to a new repository in my GitHub account. I would like to name this repository <Your-Name>-event-talks-app

它将在此处执行一系列命令：

1. 创建代码库。
2. 它将使用多个 Git 命令 (init、add、commit) 来管理本地 Git 代码库。
3. 然后，它将设置 Git 远程库并执行推送

如果一切顺利，您应该已经创建了一个 GitHub 代码库。您可以访问 GitHub 代码库页面。示例屏幕截图如下所示：

请注意，您尚未为此项目生成 README.md，这对于下一部分来说是一个很好的练习，我们现在将使用您刚刚创建的此代码库。

使用 Antigravity CLI 处理代码库

在此使用情形中，您将使用 Antigravity CLI 来处理代码库。您将执行多项任务，包括：

• 了解代码库
• 生成文档
• 实现新功能

这应该会为您提供良好的基础，以便您随后处理代码库，并使用 Antigravity CLI 作为助手来完成这些开发者特定任务。

前提条件

如需执行本部分中的任务，您需要满足以下条件：

• Antigravity CLI
• 您应该已完成上一部分，并准备好生成的代码，我们在其中创建了一个 BigQuery 版本说明阅读器。

让我们继续使用您之前用于生成 BigQuery 版本说明应用的文件夹/目录中的 Antigravity CLI。

尝试使用以下提示：

了解代码库

• 我想详细了解这个项目。请帮助我了解其主要功能，然后将其分解为服务器端和客户端。请举一个流程示例，向我展示请求和响应是如何运作的。请注意，它会创建一个新文件（制品），您可以通过**/artifact** **命令**查看所有制品或特定制品。
• 说明 @app.py

生成 README 文件

• 为该项目生成 README 文件。

实现新功能

• 请实现两个简单的实用功能：每个卡片上的“复制到剪贴板”按钮和“导出到 CSV”按钮。
• 请在标题中实现一个简单的切换开关，通过替换 CSS 根变量将页面的配色方案从深色模式切换为浅色模式。

系统应会为您提供一个方案，您可以批准该方案。获得批准后，Antigravity CLI 将继续进行这些更改。请测试您的更改，如果出现 bug（很可能），请让 Antigravity CLI 修复它。

根据建议的功能生成问题

我们来试试一些有趣的东西。您将向 Antigravity CLI 询问如何改善此应用的用户体验。

不妨试试以下提示：

• 我想请您从用户体验的角度评估该应用。易用性、响应速度、实用消息等。请列出一些改进建议，并以列表的形式提供给我。

接下来，您可以选择之前生成的问题之一，让 Antigravity CLI 解决并实现该问题。

（可选）日常任务

以下用例是您可能经常需要执行的任务。这些任务包括将文件整理到文件夹中、从网络中提取内容并进行总结、处理图片文件并从中提取内容、处理数据库等。

您可以随意探索自己喜欢的用例。

整理文件/文件夹

您可以根据需要在各种文件夹中使用 Antigravity CLI 按类型整理文件。前往您电脑上包含多个 .txt、.png、.jpg、.pdf、.mp4 等文件的文件夹。该文件夹很可能是您的桌面或“下载内容”文件夹。

前往该文件夹，然后启动 Antigravity CLI。您将先让 Antigravity CLI 创建一些文件夹：Images、Documents、Videos，然后让 Antigravity CLI 整理这些文件夹中的文件。

Antigravity CLI 通常会在执行命令（尤其是会修改文件系统的命令，例如写入、移动或删除文件）之前提示您授予权限。请务必在授予权限之前仔细查看这些提示。这是您的安全保障。

Create the following folders "Images","Documents","Videos"

然后输入以下提示：

Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.

下面展示了在我们的机器上运行的示例：

I have completed organizing your files into their respective folders. Here is a summary of the files moved:                                          
                                                                                                                                                       
  • Images: Moved 95 files ending in  .jpg  or  .jpeg  (no  .gif  files were present).                                                         
  • Documents: Moved 1 file ending in  .txt  ( 12March_Live_chat_transcript.txt ).                                                                
  • Videos: Moved 26 files ending in  .mp4 .

以下是一些其他整理场景（提示显示在每个场景旁边）：

1. 总结：对于“Documents”文件夹中的每个文档，在同一文件夹中创建一个名为“summary_ORIGINAL_FILENAME.txt”的 txt 文件，其中包含该文档主要内容的 3 句话总结。
2. 按类型分类：扫描此目录中的所有 PDF 和 DOCX 文件。将名称或内容中包含“invoice”的所有文件移至“Financial/Invoices”文件夹。将包含“receipt”的文件移至“Financial/Receipts”文件夹。所有其他 .docx 文件都移至“Reports”文件夹。
3. 提取关键信息（并“标记”）：对于“Financial/Invoices”文件夹中的每个 PDF 文件，读取其内容。如果找到日期，请将文件重命名为包含该日期（格式为 YYYY-MM-DD）的名称，例如“invoice_2025-07-26_original_name.pdf”。

总结文章（本地文件或网页）

对于以下每种情形，您可以根据需要随意更改网址、感兴趣的主题和本地文件名。提供的文件名是示例文件名，您可以将其替换为系统中的文件名。

尝试以下任一场景（提示位于每个场景旁边）：

• 总结一篇网页文章（单个网址）：前往 https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2，并总结这篇新闻报道中的 3 个主要要点。
• 总结多篇网页文章（例如，来自搜索结果）：使用 Google 搜索查找有关“Antigravity CLI”的最新新闻报道。对于前 5 篇相关文章，请用 2-3 句话总结每篇文章，并列出其网址。
• 总结本地文本文件：总结“my_research_paper.txt”中的文章要点。重点关注方法和结论。
• 总结本地 PDF：阅读“financial_report_Q2_2025.pdf”。简要说明所提及的财务表现和主要挑战。

提取特定信息（本地文件或网页）

对于以下每种情形，您可以根据需要随意更改网址、感兴趣的主题和本地文件名。提供的文件名是示例文件名，您可以将其替换为系统中的文件名。

尝试以下任一场景（提示位于每个场景旁边）：

• 从本地文章中提取实体：从“biography.txt”中列出所有已命名的个人及其相关的重要日期。
• 从 PDF 中的表格提取数据：在“quarterly_sales.pdf”中，提取第 3 页上显示“各区域的产品销售额”的表格中的数据，并以 Markdown 表格格式呈现。
• 从新闻网站提取新闻标题和来源：前往“https://news.google.com/”（或类似的新闻网站）。从首页提取主要新闻标题及其对应的新闻来源。以项目符号列表的形式呈现。
• 从电子商务页面查找商品规格：浏览至“https://www.amazon.in/Google-Cloud-Certified-Associate-Engineer/dp/1119871441”（以图书为例）。提取书名、作者和其他详细信息。以结构化 JSON 格式呈现此信息。
• 以特定格式（例如“2h37m42s”）从视频中提取时长。

根据内容回答问题（类似 RAG 的行为）

对于以下每种情形，您可以根据需要随意更改网址、感兴趣的主题和本地文件名。提供的文件名是示例文件名，您可以将其替换为系统中的文件名。

尝试以下任一场景（提示位于每个场景旁边）：

• 本地文档问答：我正在附加“user_manual.pdf”。排查网络连接问题的步骤有哪些？
• 网页上的问答：根据“https://www.who.int/news-room/fact-sheets/detail/climate-change-and-health”中的内容，世界卫生组织认为气候变化会带来哪些主要健康风险？
• 比较多个来源的信息：我有两篇新闻报道，分别是“article1.txt”和“article2.txt”，这两篇报道都讨论了近期的经济政策变化。比较并对比他们对潜在的小企业影响的看法。

基于提取的信息生成内容

对于以下每种情形，您可以根据需要随意更改网址、感兴趣的主题和本地文件名。

尝试以下任一场景（提示位于每个场景旁边）：

• 根据文章生成新闻简报：阅读 @tech_innovation_article.txt。撰写一篇简短而引人入胜的新闻简报（约 150 字），适合在公司简报中发布，重点介绍这项新技术及其潜力。
• 起草一封电子邮件，总结会议转写内容：这是一份会议转写内容文件：@meeting_transcript.txt。请起草一封电子邮件，向团队总结会议中做出的关键决策和分配的待办事项，包括每项待办事项的负责人。

Antigravity CLI 多模态支持

Antigravity CLI 通过 Gemini 支持多模型，您可以根据自己的需求让它处理不同内容格式的文件。

您将使用 Antigraity CLI 处理一批发票图片，并从中提取关键信息。请按下面给出的步骤操作：

• 在您的机器上创建一个文件夹，并从以下 GitHub 代码库下载一些发票。
• 从该文件夹启动 Antigravity CLI

使用以下提示以表格形式从发票中提取信息。

The current folder contains a list of invoice files in Image format. Go through all the files in this folder and extract the following invoice information in the form of a table: Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount.

理想情况下，您应该会看到如下所示的输出：

以下是另一个示例，您可以在其中请求添加其他派生列。假设您想针对所有已过期的账单截止日期显示一个红色叉号表情符号。您可以按如下方式提供提示：

list all files with .png extension in this folder. Extract the invoice information from it by reading them locally and display it in a table format containing the following column headers: : Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount. Add a column at the end of the table that shows a red cross emoji in case the due date is in the past.

这会生成以下输出：

您可以将此方法应用于任何非文本格式的自有文件。

使用 Antigravity CLI 生成数据

您可以提示 Antigravity CLI 以各种数据格式生成数据。这可能包括您可能需要模拟的内容片段到 JSON 数据。我们在此重点介绍适用于开发者/测试者的场景。

以下是一些可尝试的提示：

生成示例客户评价的 JSON 数据

Generate a JSON array of 3 synthetic customer reviews for a new smartphone. Each review should have 'reviewId' (string, UUID-like), 'productId' (string, e.g., 'SMARTPHONE_X'), 'rating' (integer, 1-5), 'reviewText' (string, 20-50 words), and 'reviewDate' (string, YYYY-MM-DD format).

生成模拟 API 响应 (JSON)

Generate a JSON array representing 7 daily sales records for a mock API endpoint. Each record should include 'date' (YYYY-MM-DD, chronologically increasing), 'revenue' (float, between 5000.00 and 20000.00), 'unitsSold' (integer, between 100 and 500), and 'region' (string, either 'North', 'South', 'East', 'West').

生成示例数据库插入语句 (SQL)

Generate 5 SQL INSERT statements for a table named 'users' with columns: 'id' (INTEGER, primary key), 'username' (VARCHAR(50), unique), 'email' (VARCHAR(100)), 'password_hash' (VARCHAR(255)), 'created_at' (DATETIME, current timestamp). Ensure the password_hash is a placeholder string like 'hashed_password_X'.

生成用于数据加载/分析的 CSV 数据

Generate 10 lines of CSV data, including a header row, for customer transactions. Columns should be: 'TransactionID' (unique string), 'CustomerID' (integer), 'ItemPurchased' (string, e.g., 'Laptop', 'Monitor', 'Keyboard'), 'Quantity' (integer, 1-3), 'UnitPrice' (float, between 100.00 and 1500.00), 'TransactionDate' (YYYY-MM-DD).

生成配置文件 (YAML)

Generate a sample YAML configuration for a 'user_service'. Include sections for 'database' with 'host', 'port', 'username', 'password', 'database_name'. Also include a 'api_keys' section with 'payment_gateway' and 'email_service' placeholders. Use realistic default values.

为极端情况/验证生成测试数据

Generate a JSON array of 8 email addresses for testing purposes. Include a mix of: 2 valid standard emails, 2 with missing '@', 2 with invalid domains (e.g., '.com1'), and 2 with special characters in the local part that are usually invalid (e.g., spaces or multiple dots).

9. 恭喜

恭喜！您已成功探索了 Antigravity CLI 及其功能，并将其应用到了几个用例中。

参考文档

• Antigravity CLI 项目首页
• Antigravity CLI 文档