Skip to content

Instances zh

Ra1nify edited this page Oct 31, 2026 · 1 revision

实例

实例是一个独立的 Antigravity 运行槽位。每个实例拥有独立的 UserData、.gemini 与 AppData,互不共享进程与登录态。

列表字段

列 含义
名称 创建时指定,可重命名
短 ID 实例 ID 前 8 位,用于区分同名实例
账号 绑定的号池账号。未绑定显示 未绑定
项目 绑定的项目数量
状态 运行中 / 已停止
PID 运行中的进程 ID

顶部按钮

按钮 行为
新建实例 打开新建对话框,填写名称后可绑定账号与项目
刷新 重新读取进程状态与端口
全部停止 依次终止所有运行中的实例进程

行内按钮

按钮 行为 前置条件
启动 以该实例的沙盒目录启动 Antigravity 核心已安装
停止 终止该实例进程 实例运行中
配置 打开实例配置对话框:名称、账号、绑定项目、代理 —
删除 移除实例定义及其沙盒目录 实例已停止

启动流程

启动实例时依次执行:

  1. 校验核心目录存在;
  2. 检查账号互斥锁。账号已被其他运行中实例占用时弹出风险确认;
  3. 为实例生成 UserData 与 .gemini 目录;
  4. 挂载共享池:skills、plugins、mcp 以 Junction 指向 <安装目录>\shared\;
  5. 挂载项目记忆:单项目绑定时 brain 与 conversations 整目录 Junction;多项目绑定时按会话逐条 Junction;
  6. 注入材质与本地化补丁到 utils.js;
  7. 以独立 --user-data-dir 启动 Antigravity.exe。

账号互斥

一个账号在同一时刻只能被一个运行中的实例使用。

情况 处理
账号空闲 直接启动
账号被同一实例持有 直接启动
账号被其他实例持有 弹出风险确认。确认后终止原进程、清除锁并启动
账号被持有但进程已退出 视为残留锁,可清除后启动

残留锁可在号池页的 强制解锁 处理。

项目挂载

绑定项目数 挂载方式 共享行为
0 实例自有空目录 不共享
1 brain、conversations 整目录 Junction 双向共享。实例内新建会话直接写入项目
≥2 实例自有目录 + 每会话 Junction 单向快照。挂载时引入项目已有会话;实例新建会话在进程退出时回写

多项目模式下,新会话回写的条件:

  1. 实例进程退出;
  2. 该会话的 workspace_uris 包含某个绑定项目的路径。

未满足条件时,会话保留在实例沙盒内,其他实例不可见。

停止流程

  1. 终止进程;
  2. 多项目模式下执行会话回写;
  3. 释放账号互斥锁;
  4. 更新实例状态与 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_*

Clone this wiki locally