Repository navigation
Instances zh
Ra1nify edited this page Oct 31, 2026
·
1 revision
实例是一个独立的 Antigravity 运行槽位。每个实例拥有独立的 UserData、.gemini 与 AppData,互不共享进程与登录态。
| 列 | 含义 |
|---|---|
| 名称 | 创建时指定,可重命名 |
| 短 ID | 实例 ID 前 8 位,用于区分同名实例 |
| 账号 | 绑定的号池账号。未绑定显示 未绑定
|
| 项目 | 绑定的项目数量 |
| 状态 | 运行中 / 已停止 |
| PID | 运行中的进程 ID |
| 按钮 | 行为 |
|---|---|
新建实例 |
打开新建对话框,填写名称后可绑定账号与项目 |
刷新 |
重新读取进程状态与端口 |
全部停止 |
依次终止所有运行中的实例进程 |
| 按钮 | 行为 | 前置条件 |
|---|---|---|
启动 |
以该实例的沙盒目录启动 Antigravity | 核心已安装 |
停止 |
终止该实例进程 | 实例运行中 |
配置 |
打开实例配置对话框:名称、账号、绑定项目、代理 | — |
删除 |
移除实例定义及其沙盒目录 | 实例已停止 |
启动实例时依次执行:
- 校验核心目录存在;
- 检查账号互斥锁。账号已被其他运行中实例占用时弹出风险确认;
- 为实例生成
UserData与.gemini目录; - 挂载共享池:
skills、plugins、mcp以 Junction 指向<安装目录>\shared\; - 挂载项目记忆:单项目绑定时
brain与conversations整目录 Junction;多项目绑定时按会话逐条 Junction; - 注入材质与本地化补丁到
utils.js; - 以独立
--user-data-dir启动Antigravity.exe。
一个账号在同一时刻只能被一个运行中的实例使用。
| 情况 | 处理 |
|---|---|
| 账号空闲 | 直接启动 |
| 账号被同一实例持有 | 直接启动 |
| 账号被其他实例持有 | 弹出风险确认。确认后终止原进程、清除锁并启动 |
| 账号被持有但进程已退出 | 视为残留锁,可清除后启动 |
残留锁可在号池页的 强制解锁 处理。
| 绑定项目数 | 挂载方式 | 共享行为 |
|---|---|---|
| 0 | 实例自有空目录 | 不共享 |
| 1 |
brain、conversations 整目录 Junction |
双向共享。实例内新建会话直接写入项目 |
| ≥2 | 实例自有目录 + 每会话 Junction | 单向快照。挂载时引入项目已有会话;实例新建会话在进程退出时回写 |
多项目模式下,新会话回写的条件:
- 实例进程退出;
- 该会话的
workspace_uris包含某个绑定项目的路径。
未满足条件时,会话保留在实例沙盒内,其他实例不可见。
- 终止进程;
- 多项目模式下执行会话回写;
- 释放账号互斥锁;
- 更新实例状态与
projects.json中的运行标记。
删除实例会移除:
-
data\instances\{id}\(沙盒、.gemini、UserData) -
data\instances.json中的实例定义
不会移除项目记忆库与共享池。实例运行中时删除按钮不可用。
| 文件 | 作用 |
|---|---|
data/instances.json |
实例定义与绑定关系 |
data/instances/{id}/ |
实例沙盒 |
src/Gravityless.Core/Services/InstanceService.cs |
创建、启动、停止、挂载 |
src/Gravityless.App/Resources/Languages/*.xaml |
本页文案键 Instances_*
|
Gravityless · GPL-3.0 · English | 简体中文