Skip to content

Accounts zh

Ra1nify edited this page Oct 31, 2026 · 1 revision

号池

号池保存本机可用的 Google 账号,并记录它们的凭据、绑定关系与额度。

Antigravity 2.28 起,凭据存储在 Windows 凭据管理器中的单一全局条目里,系统内同一时刻只允许一个账号持有登录态。因此号池的性质是账号仓库,不是并行容器:账号可以在列表中共存,但同一时刻只有一个能处于运行状态。

关于这一限制的成因与验证过程,见 Multi-Instance。

列表字段

列 含义
账号 Google 邮箱,或自定义显示名
状态 空闲 / 使用中
绑定实例 占用该账号的运行中实例
Gemini 5h / 7d 额度剩余比例与重置时间
Claude 5h / 7d 额度剩余比例与重置时间

额度为 null 时显示 --,表示未获取或已过期。

顶部按钮

按钮 行为
新建沙盒捕获 启动临时 Antigravity 实例,登录后自动归档凭据
刷新全部 Token 依次刷新所有账号的 OAuth token 与额度
全部强制解锁 清除所有账号的互斥锁

行内按钮

按钮 行为
详情 打开账号详情:凭据路径、额度、绑定关系、显示名
刷新 Token 刷新单个账号的 token 与额度
强制解锁 清除该账号的互斥锁
删除 移除账号定义与凭据归档

删除 前置条件:账号未被运行中的实例占用。凭据归档目录 data\accounts\{id}\ 一并移除。

捕获流程

新建沙盒捕获 启动一个独立实例:

  1. 创建临时沙盒目录,设置 USERPROFILE / HOME / APPDATA / LOCALAPPDATA 指向沙盒;
  2. 备份并清空宿主凭据槽位,使沙盒处于未登录状态;
  3. 启动 Antigravity,等待用户完成登录;
  4. 同时监听两个信号:
    • 沙盒内 .gemini\oauth_creds.json 的写入;
    • Windows 凭据管理器中 gemini:antigravity 的出现;
  5. 从信号内容解析 id_token_email,归档凭据到 data\accounts\{id}\;
  6. 恢复宿主凭据,关闭临时实例,释放锁。

捕获期间界面显示阶段提示。取消捕获时恢复宿主凭据、关闭临时实例,不写入号池。

整个捕获过程持有互斥锁,期间无法启动其他实例。

互斥锁

锁状态保存在 data/accounts.json 与账号凭据目录中。

情况 处理
账号空闲 登记占用实例 ID 与 PID
账号被同一实例占用 视为重入,允许
账号被其他实例占用且进程存活 启动失败,提示冲突
账号被其他实例占用但进程已退出 判定为残留锁,允许强制接管

强制解锁 清除占用实例 ID 与 PID,不修改凭据文件。

除账号级锁之外,还有一个进程级的凭据槽位锁(CredentialManager.SlotLock,超时 10 秒),用于串行化对全局凭据条目的读写。

凭据槽位让渡

由于凭据槽位是全局单例,Gravityless 在实例启动后主动让出它:

1. 启动实例时写入该账号的凭据
2. 等待语言服务器完成读取(约 8 秒)
3. 清除凭据槽位
4. 下一个实例可写入其他账号

该行为的依据是语言服务器只在启动阶段读取凭据,之后用内存中的 refresh_token 续期。

情况 处理
凭据属于当前账号 清除
凭据属于其他账号 跳过,避免误删
槽位为空 跳过
进程在等待窗口内退出 跳过,保留槽位供重试

实例记录中的 CredentialSlotReleased 字段标识该实例是否已完成让渡。

跨账号启动提示

当目标实例绑定的账号与当前槽位持有者不一致时,启动前弹出确认:

当前凭证槽位由 A 占用。
启动本实例会写入 B 的凭证,可能扰乱正在运行实例的登录状态。

确认启动即视为接受该风险。

取消则不启动。确认后按常规流程启动。

凭据归档

data\accounts\{id}\
  google_accounts.json     账号基本信息
  oauth_creds.json         OAuth 凭据
  installation_id          设备标识

凭据为明文 JSON。整个 data\ 目录应视为敏感数据。

额度刷新

刷新调用账号对应的配额接口,写入以下字段:

字段 含义
Gemini5hFraction Gemini 5 小时窗口剩余比例,0–1
Gemini5hResetTime 该窗口重置时间
Gemini7dFraction Gemini 7 天窗口剩余比例
Gemini7dResetTime 该窗口重置时间
Claude5hFraction / Claude7dFraction 同上,Claude 模型
QuotaLastFetchedAt 最近一次成功获取的时刻
QuotaRawText 接口原始响应

刷新失败时保留原值,FailedRefreshAttempts 累加,界面提示失败原因。批量刷新逐个执行,单个失败不中断其余。

已知限制

refresh_token 续期成功后会回写凭据槽位。若此时槽位已被其他账号占用,回写会产生错误覆盖。因此号池适用于串行切换,不适用于不同账号的长期并行运行。

相关文件

文件 作用
data/accounts.json 账号定义与锁状态
data/accounts/{id}/ 凭据归档
src/Gravityless.Core/Services/AccountPoolService.cs 捕获、锁定、刷新
src/Gravityless.Core/Native/CredentialManager.cs 凭据槽位读写与让渡
src/Gravityless.App/Resources/Languages/*.xaml 本页文案键 Accounts_*

Clone this wiki locally