Antigravity¶
T3 Code 会在你选择的环境中运行 Google 官方的 Antigravity ACP 代理。它有自己的登录流程,与 Antigravity IDE 或 CLI 的登录是分开的。Google 控制着通过该代理可用的模型和账户访问权限。
设置 Antigravity¶
在 Web 端或桌面端,打开 设置 > 提供商,选择运行你项目的环境,并启用 Antigravity。在该环境中安装其运行时,然后选择 登录 并完成浏览器登录。在开始一个线程之前,请等待 T3 Code 确认账户访问权限并加载模型。运行时安装完成后,你也可以在移动应用的 设置 > 提供商 中登录。
即使你离开设置页面或重新连接,安装也会继续。设置需要操作环境的权限;如果较旧的服务器不提供 Antigravity 设置选项,请更新该服务器。
从远程设备登录¶
Google 会返回到一个 127.0.0.1 地址。当你的浏览器位于环境所在机器上时,登录可以直接完成。从其他设备发起时,最终页面通常会加载失败,因为登录监听器位于环境上。
将完整返回地址(包括 ? 之后的所有内容)复制到你发起登录的客户端中的返回 URL 字段,然后选择 继续。保留原始地址;不要将其替换为服务器的主机名。只有该 T3 Code 登录会话能完成此次尝试。如果它过期了,请重试登录并使用新的链接。
返回 URL 包含一个临时登录代码。请仅将其粘贴到设置字段中。仅成功加载回调页面并不能确认账户访问权限;请等待 T3 Code 的确认。
其他登录方式¶
在 Antigravity 提供商设置中选择 登录方式:
| 方式 | 凭据 |
|---|---|
| Google 账户 | 在浏览器中使用个人 Google 登录 |
| Gemini Enterprise | 浏览器登录、GCP 项目和 GCP 位置 |
| Gemini API 密钥 | API 密钥;选择 Connect(无需浏览器) |
| Agent Platform / Vertex AI | API 密钥,或使用环境上的应用默认凭据的 GCP 项目和位置 |
环境会将 Antigravity API 密钥存储在其设置文件之外,客户端只能看到是否已保存密钥。代理使用为该实例选择的方法和凭据;环境中的 GEMINI_API_KEY 和 Google 凭据变量不会覆盖它们。更改方法会停止该实例的会话。在替换账户之前,请先退出登录。
运行时安装¶
托管安装支持 Apple Silicon macOS、Linux x64 或 ARM64、Windows x64 或 ARM64。Intel Mac 可以连接到受支持的远程环境。请预留数 GB 的可用磁盘空间,尤其是在 Linux 上。
使用手动安装¶
从 官方 ACP Registry 下载适用于你的环境的压缩包。将 ACP 可执行文件及其 localharness_external 辅助程序解压到同一目录,并保持相同版本。在 macOS 或 Linux 上,将两者设为可执行;Windows 使用 .exe 文件。
将 二进制路径 设置为环境上的 ACP 可执行文件,并自行更新。将该字段留空以使用托管运行时;如果未安装托管运行时,则使用 PATH 上兼容的可执行文件。
模型与线程¶
模型列表来自你的 Antigravity 账户;当你的套餐包含 Claude 和 GPT 模型时,它们也会出现在列表中。在模型选择器的模型列表旁边选择一个思考级别;该列表只显示所选模型支持的级别。恢复的线程会保留其选定的模型。如果对该模型的访问权限结束,请在继续之前选择另一个可用模型。
Antigravity 会在会话启动时在工作区中创建空的 .gemini/skills 和 .agents/skills 文件夹。Git 不跟踪空文件夹,因此它们永远不会出现在提交中。
使用 Antigravity 原生的 /plan 命令进行规划。工具审批遵循 权限模式。即使处于 完全访问 模式,带有固定选项的问题仍然需要选择其中一个提供的答案。
T3 Code 会保留对话历史和文件差异,但 Antigravity 无法回退其对话。因此,无法回退线程或编辑并重新提交之前的回合。请继续发送后续消息或开始新线程。
通过 Antigravity 的 ACP 运行时无法进行手动上下文压缩,尽管其 CLI 提供 /compact 命令。当你需要全新上下文时,请发送 /clear。
技能与附件¶
将项目技能放在 .agents/skills 中。T3 Code 还会读取 .gemini/skills 和旧版 .agent/skills 目录。在这些项目位置中,按以下顺序最先找到的副本生效:.gemini/skills、.agents/skills、.agent/skills。有关调用方法,请参阅 命令与技能。
适用于所有项目的技能放在 ~/.gemini/config/skills 或 ~/.gemini/antigravity-cli/skills 中。Antigravity 不会读取 ~/.agents/skills,因此该位置中的技能只有当项目本身是你的主目录时才会出现。
Antigravity 直接接收图像和音频,并将 PDF 和文本文件作为文档读取。在 macOS 和 Linux 上使用托管运行时,大小不超过 20 MiB 的 MP4 视频会作为视频发送给 Gemini 模型。其他附件以及其他模型的视频则会以保存的文件路径形式传递,供代理使用其工具检查。
子代理¶
Antigravity 将子代理活动分组为批次。打开一个批次并选择 子代理工作(移动端为 工作),即可查看每个子代理的角色、提示词和最近步骤。此视图为只读:你不能向单个子代理发送消息或控制它们,空闲批次也不表示所有子代理都已成功。如果 Antigravity 未记录某批次启动了哪些子代理,视图会说明这一点。有关在何处查看活动,请参阅 代理工作。
账户与移除¶
在 Web 或桌面端的 设置 > 提供程序 中,为每个 Google 账户添加一个 Antigravity 提供程序实例。每个实例都有自己的登录;已下载的运行时在环境中共享。
| 操作 | 效果 |
|---|---|
| 禁用 | 停止该实例的会话,并保留其 Google 登录状态。 |
| 退出登录 | 停止该实例的会话,并移除其已保存的 Google 登录信息。 |
| 移除已下载的运行时 | 移除共享安装,并保留 Google 凭据。 |
这三种操作都会保留线程历史和工作区文件。在线程中单独发送 /logout 会使其实例退出登录,包括停止该实例的其他会话。先退出登录,再重新登录以替换账户。
在移除托管运行时之前,请先禁用其实例并取消任何进行中的安装。清除指向该运行时的任何显式二进制路径。如果该运行时正在使用中,系统会拒绝移除操作。
检查访问权限和排查故障¶
打开 用量 > 限额 可查看 Google 登录账户剩余的 Gemini 配额和共享 Claude/GPT 配额。每个分组都有独立的五小时限额、每周限额和重置时间。限额会随提供程序状态刷新,并包含 T3 Code 之外的使用量。
服务器重启会保留你的 Google 登录状态。提供程序会显示已保存的账户,直到某个会话、刷新或退出登录报告新的变化。
要检查访问权限并重新加载模型,请在 Web 或桌面端的提供程序设置中使用 刷新提供程序状态,或在移动端的线程设置中使用 刷新模型。如果系统要求再次登录,请使用 Web 或桌面端的提供程序设置,或移动端上的 设置 > 提供程序。
如果 Google 报告 SUBSCRIPTION_REQUIRED、账户限制或使用限制,请遵循提供程序的消息和任何重试时间。有关资格,请参阅 Google 的账户套餐。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 t3/t3code