Antigravity Accounts Manager

Publisher / 发布者：HanYue · Version / 版本：0.2.2

English · 中文 · Privacy / 隐私政策 · Changelog / 更新记录 · Feedback / 反馈

Documentation-only repository. It contains user documentation and privacy/support information, not the extension's source code, OAuth client configuration, compiled JavaScript or VSIX binaries. Public documentation does not imply that the extension is open source or already available in Marketplace.

此仓库仅提供说明文档。 不包含插件源码、OAuth 客户端配置、编译 JavaScript 或 VSIX 文件。公开文档不代表插件开源，也不代表已经上架商店。

English

An unofficial desktop VS Code dashboard for monitoring Antigravity model quotas. Sign in with Google OAuth and query quotas directly; no CLIProxyAPI service or management key is needed.

Features

• Dashboard and sidebar with gauges, remaining percentages and reset countdowns.
• Gemini, Claude / GPT and Gemini 4 Argon quota groups; 5-hour and weekly periods when returned by Google.
• Multiple accounts, manual refresh and configurable polling (5 minutes by default).
• Status-bar summary, low-quota notifications, light/dark themes and account masking.
• OAuth with PKCE, automatic local callback, copy-link and manual callback fallback.

The interface and command labels in 0.2.1 are primarily Chinese; this documentation is bilingual. Linux is the primary validation platform. Requires desktop VS Code 1.95+ and access to Google services; vscode.dev is not supported.

Install and sign in

Until the publisher completes Marketplace submission and the listing is publicly available, install only a VSIX supplied through a trusted publisher channel. No binary is hosted in this repository. Manual publisher steps are in PUBLISHING.md.

After publication, search VS Code Extensions for @id:HanYue.antigravity-accounts-manager. Expected listing URL (not proof of current availability): https://marketplace.visualstudio.com/items?itemName=HanYue.antigravity-accounts-manager .

1. Run Antigravity：打开额度仪表盘 in the Command Palette.
2. Click 添加账号, read the non-official-client warning and confirm.
3. Click 在浏览器中打开 or copy the authorization URL and open it in a browser on the same machine.
4. Complete Google's consent flow. The extension listens on a temporary 127.0.0.1 port for the callback.
5. If automatic callback fails, paste the full callback URL into the login dialog. Each session expires after approximately five minutes.

If the system browser cannot launch, the session remains waiting so that you can copy the link. Tokens are saved using VS Code SecretStorage; a login saved successfully does not guarantee quota endpoint access. Re-adding the same Google account updates its local login.

The public extension ID differs from earlier local-tools builds and HanYue 0.2.0 candidates. Disable/uninstall those builds to avoid duplicate views and polling, then sign in again. No credential migration is performed.

Settings

There is no CLIProxyAPI endpoint setting in 0.2.1. Account selection only changes monitoring, not other clients. Missing values are not reported as zero; stale results are labeled after query failures. Countdown expiry requires a new query to confirm a reset. This is polling, not real-time streaming.

Privacy and limitations

This is not an official Google product. It uses a community-published desktop OAuth client not registered to HanYue and internal Google APIs. It requests broad scopes including Cloud Platform and AI Code, not a dedicated read-only quota permission. Google may reject the client or change the API. Community source availability does not establish permission to redistribute/use Google's client. No Google approval or general availability guarantee is claimed. The project owner has reported a successful real account authorization, not an independent compliance review or a guarantee for every account.

Accounts and tokens are stored in VS Code SecretStorage; quotas are cached in memory. Tokens are not sent to the dashboard, the publisher or a developer-operated backend. Google receives authorization, identity, token, project and quota requests; project initialization may be attempted when missing. No model-generation request or extension telemetry is sent. See the full privacy policy.

Use account removal/clear-all to delete local credentials. This does not revoke Google consent; review the corresponding client at https://myaccount.google.com/connections . Clear credentials before uninstalling; uninstall alone is not an erasure guarantee. Do not share authorization URLs, callback URLs, tokens or unredacted screenshots in public issues.

Troubleshooting

• Browser launch failure: copy the URL manually; use the same local machine.
• Callback rejected/expired: use the full URL for the current session; expired sessions require new sign-in.
• invalid_client / invalid_scope / invalid_request: client, scope, PKCE or callback compatibility may be rejected; checks are not bypassed.
• invalid_grant / 401: reauthorize the account.
• 403 / missing project / empty quotas: login may succeed while internal API access is unavailable. Retry later or complete official Antigravity setup first.
• SecretStorage failure: check Linux system keyring; there is no plaintext fallback.
• Network failure: check Google access and trusted certificates. Host proxy behavior depends on VS Code; editor http.proxy support is not guaranteed.

中文

面向 Linux 桌面 VS Code 的非官方 Antigravity 多账号额度仪表盘，独立 OAuth 登录，直接查询 Google，无需本机 CLIProxyAPI 服务或管理密钥。

功能与安装

提供完整仪表盘、紧凑侧栏、5 小时/周额度（以接口返回为准）、剩余比例、重置倒计时、手动/定时刷新、状态栏与低额度提醒。保留 Gemini、Claude/GPT、Gemini 4 Argon 分组，支持主题和账号信息隐藏。

需要桌面 VS Code 1.95+、可访问 Google 的网络及可用的系统密钥环；主要验证平台为 Linux，不支持 vscode.dev。当前 UI 和命令主要为中文。

在发布者完成提交、商店公开可用前，仅通过可信发布者渠道安装 VSIX；此仓库不托管安装包。发布者手动上传说明。商店公开后搜索 @id:HanYue.antigravity-accounts-manager。预期商店地址不代表已经上线：https://marketplace.visualstudio.com/items?itemName=HanYue.antigravity-accounts-manager 。

打开命令面板执行 Antigravity：打开额度仪表盘 → 添加账号 → 阅读提示 → 在浏览器中打开。无法自动打开时复制授权链接，在同一本机浏览器打开。自动回调失败时粘贴本次完整回调 URL；会话约 5 分钟过期。登录保存后再查询额度，登录成功不保证内部额度接口可用。

商店版 ID 为 HanYue.antigravity-accounts-manager，与旧 local-tools 及 Monitor 候选版隔离，请先停用/卸载旧版并重新登录，不迁移凭据。0.2.1 不使用 CLIProxyAPI 根地址；旧设置值可自行清理。配置默认每 5 分钟刷新、剩余 ≤20% 提醒，状态栏可选模型分组，详见上方设置表。账号切换只改变监控对象，不修改 IDE 或代理登录。

隐私与限制

不是 Google 官方产品。 使用社区公开桌面 OAuth 客户端及 Google 内部接口，客户端不是为 HanYue 注册。权限包括 Cloud Platform、AI Code 等，非专用只读额度权限。公开源码不等于 Google 客户端使用或分发许可；不声称获 Google 批准，不能保证长期可用或所有账号兼容。项目所有者报告过真实账号授权成功，不等于合规审核或全面兼容性验证。

令牌保存在 SecretStorage，不传入页面、不上传给发布者；额度缓存只在内存中。请求直接发送到 Google，项目缺失时可能尝试初始化。不调用模型生成、不添加遥测。缺失值不补成 0%，刷新失败会标明旧数据，倒计时结束需刷新确认。完整隐私政策。

移除/清空只删除插件本地凭据，不撤销 Google 授权；彻底撤销请在 https://myaccount.google.com/connections 检查授权客户端。卸载前建议先清空账号，卸载本身不保证擦除 SecretStorage。请勿在公开 Issues 提交令牌、授权链接、完整回调或未脱敏截图。

常见问题与反馈

• 浏览器打不开：复制链接手动打开，当前会话继续等待。
• 回调错误或过期：使用本次完整地址，过期则重新登录。
• invalid_client / invalid_scope / invalid_request：客户端、权限、PKCE 或回调可能被拒绝，不绕过检查。
• invalid_grant / 401：重新添加同一账号授权。
• 403、缺少项目、空额度：可能没有内部接口访问权，可稍后重试或先在官方客户端完成开通。
• 密钥环错误：检查 Linux 系统密钥环，不会降级保存明文令牌。
• 网络错误：检查 Google 访问及可信证书，VS Code 宿主代理行为不作统一保证。

反馈入口 · 版本记录 · 第三方声明