Repository navigation
Accounts zh
号池保存本机可用的 Google 账号,并记录它们的凭据、绑定关系与额度。
Antigravity 2.28 起,凭据存储在 Windows 凭据管理器中的单一全局条目里,系统内同一时刻只允许一个账号持有登录态。因此号池的性质是账号仓库,不是并行容器:账号可以在列表中共存,但同一时刻只有一个能处于运行状态。
关于这一限制的成因与验证过程,见 Multi-Instance。
| 列 | 含义 |
|---|---|
| 账号 | Google 邮箱,或自定义显示名 |
| 状态 | 空闲 / 使用中 |
| 绑定实例 | 占用该账号的运行中实例 |
| Gemini 5h / 7d | 额度剩余比例与重置时间 |
| Claude 5h / 7d | 额度剩余比例与重置时间 |
额度为 null 时显示 --,表示未获取或已过期。
| 按钮 | 行为 |
|---|---|
新建沙盒捕获 |
启动临时 Antigravity 实例,登录后自动归档凭据 |
刷新全部 Token |
依次刷新所有账号的 OAuth token 与额度 |
全部强制解锁 |
清除所有账号的互斥锁 |
| 按钮 | 行为 |
|---|---|
详情 |
打开账号详情:凭据路径、额度、绑定关系、显示名 |
刷新 Token |
刷新单个账号的 token 与额度 |
强制解锁 |
清除该账号的互斥锁 |
删除 |
移除账号定义与凭据归档 |
删除 前置条件:账号未被运行中的实例占用。凭据归档目录 data\accounts\{id}\ 一并移除。
新建沙盒捕获 启动一个独立实例:
- 创建临时沙盒目录,设置
USERPROFILE/HOME/APPDATA/LOCALAPPDATA指向沙盒; - 备份并清空宿主凭据槽位,使沙盒处于未登录状态;
- 启动 Antigravity,等待用户完成登录;
- 同时监听两个信号:
- 沙盒内
.gemini\oauth_creds.json的写入; - Windows 凭据管理器中
gemini:antigravity的出现;
- 沙盒内
- 从信号内容解析
id_token_email,归档凭据到data\accounts\{id}\; - 恢复宿主凭据,关闭临时实例,释放锁。
捕获期间界面显示阶段提示。取消捕获时恢复宿主凭据、关闭临时实例,不写入号池。
整个捕获过程持有互斥锁,期间无法启动其他实例。
锁状态保存在 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_*
|
Gravityless · GPL-3.0 · English | 简体中文