面向 Linux 无头环境(SSH 服务器、Docker 容器、WSL2、CI) 的官方 Antigravity CLI(agy)多账号管理、配额巡检与自动/手动凭据切换工具。
Important
开源许可证与非商业使用声明(CC-BY-NC-SA-4.0)
本项目基于上游 agy-switch(基线提交 e5c8eaf5,v4.10.15)独立重构衍生,遵循 CC-BY-NC-SA-4.0(署名-非商业性使用-相同方式共享 4.0)。复制、修改与再分发仅限非商业用途;商业场景使用须事先取得上游著作权人书面授权。详见 LICENSE 与 PROVENANCE.md。
- 纯无头零桌面依赖:彻底剥离 Tauri / GTK / WebKit,预编译
musl产物为 100% 纯静态单文件 ELF,在各类x86_64与aarch64Linux 发行版上开箱即用。 - 无浏览器 OAuth 登录与零丢码保护:默认免端口监听直接粘贴回调 URL 登录(亦可加
--ssh开启本地端口转发回调);令牌签发后立即以0600权限落盘并建立两级防回退指纹库,网络中断可通过auth pending --resume无损续传。 - 灵活的手动与自动切号方式:
- 重要事实:切换凭据槽位默认对切换后新启动的
agy进程生效,不会篡改或打断正在运行中的agy会话。 - 既可通过
tui终端看板或switch手动切号后直接运行agy,也可按需使用agy-switch-cli run -- agy在启动前自动评估切号,或配合systemd --user运行daemon后台巡检守护进程。
- 重要事实:切换凭据槽位默认对切换后新启动的
前往 Releases 页面下载对应架构的 .tar.gz 包(远程 SSH 服务器 / Docker 容器 / WSL2 下载不带 -all-features 的标准版即可;若在开启了 GNOME Keyring / KDE Wallet 的 Linux 图形桌面环境中使用,建议下载 -all-features 版,程序会自动检测并同步更新系统钥匙串与本地凭据文件):
sha256sum -c agy-switch-cli-v1.1.1-x86_64-unknown-linux-musl.tar.gz.sha256
tar -xzf agy-switch-cli-v1.1.1-x86_64-unknown-linux-musl.tar.gz
mkdir -p ~/.local/bin
install -m 0755 agy-switch-cli-v1.1.1-x86_64-unknown-linux-musl/agy-switch-cli ~/.local/bin/agy-switch-clicargo build --release --locked
install -m 0755 target/release/agy-switch-cli ~/.local/bin/agy-switch-cli# 1. 环境体检与官方 agy 版本探测
agy-switch-cli doctor --verify-agy
# 2. 登录添加账号(默认零配置手动粘贴回调 URL;如需本地监听可加 --ssh)
agy-switch-cli auth login --label "主力账号"
# 若当前设备已登录过官方 agy(或桌面端 Antigravity),也可一键读取本机当前登录账号入库:
# agy-switch-cli accounts add --from-local --label "本机账号"
# 或从原桌面版 ~/.antigravity_tools 只读迁移已有账号(不修改原目录):
# agy-switch-cli accounts import --from-legacy
# 3. 联网刷新并直接查看所有账号的最新配额进度表
agy-switch-cli quota -r --all
# 4. 查看当前生效账号、运行状态与该账号支持的全部模型列表
agy-switch-cli current
# 5. 打开交互式看板管理与切号,之后直接运行 agy 即可(也可用 `agy-switch-cli run -- agy` 启动前按需自动切号)
agy-switch-cli tui(网络代理提示:Linux 图形界面的“系统代理”不会自动注入终端环境。若需走代理连接 Google,单次命令可加 --proxy http://127.0.0.1:7890,当前终端免重复传参可执行 export https_proxy=http://127.0.0.1:7890,需要跨终端与后台 daemon 持久生效则将其写入 ~/.local/share/agy-switch-cli/config.json,详见使用手册第 6 节。)
| 命令 | 用途说明 |
|---|---|
agy-switch-cli doctor [--fix] |
诊断本地存储、权限、D-Bus 环境,并对账修复未完成的切换日志 |
agy-switch-cli auth login [--ssh] |
通过 PKCE (S256) 添加新 Google 账号(默认粘贴回调 URL;重新授权用 reauthorize) |
agy-switch-cli accounts list / add / import / export |
查看账号详情与排序(--move/--order)、导入本机已登录号(--from-local)或批量添加 Token、导入导出备份 |
agy-switch-cli current |
查看当前生效身份、运行中进程状态及该账号支持的全部模型清单 |
agy-switch-cli quota [-r] [--all] |
查看双窗口(Weekly + 5h)配额进度表(加 -r 先联网刷新再展示) |
agy-switch-cli switch <ID|EMAIL> |
手动切换生效账号(标准版改本地槽位文件;-all-features 版自动检测并双写桌面钥匙串与文件) |
agy-switch-cli policy set --all-candidates ... |
配置自动切号水位策略(可配合 run 启动前按需切号或 daemon 后台每小时巡检) |
agy-switch-cli run [--isolate-dbus] -- agy ... |
启动 agy 前按策略自动检查切号并隔离桌面钥匙串干扰 |
agy-switch-cli tui |
打开 SSH 交互式终端看板(支持切号、r/R 单条/批量刷新、K/J 调序与 c/C/p 策略管理) |
(所有业务子命令均支持 --json 机器可读输出与 0..=8 稳定退出码。)
- 完整使用、配置与部署手册 (
docs/user-guide.md):标准版与全特性版选型实例、全量命令与退出码参考、config.json代理配置、systemd --user部署及常见故障排查。 - 技术架构、安全机制与验收台账 (
docs/architecture-and-verification.md):目录拓扑、四级单向锁与授权世代防回退设计、4 目标 × 3 档 Release 体积/性能矩阵及诚实验收边界说明。 - 重构溯源与第三方合规声明 (
PROVENANCE.md) & 许可证全文 (LICENSE)。
- 上游项目致谢:感谢
anglee0323/agy-switch及其贡献者提供的原始领域探索与桌面端参考实现。 - AI 协同研发与独立安全审查致谢:
- Gemini 4 Carbon:负责本项目的独立无头架构重构、四级锁与防回退核心代码实现、全套自动化测试矩阵、跨架构纯静态构建及全中文工程文档编写;
- GPT 6.1 Sol:担任独立第三方首席发版签核审计师,对本项目执行了四轮零信任源码深审、并发交错与故障注入探针验证及合规放行签核;
- 由项目维护者提供需求定义、构建验证环境与全流程统筹把关。