Antigravity Usage Status Bar (VS Code Extension)
A lightweight, clean, and private VS Code status bar extension that displays your Google Antigravity AI quota usage in real time.
将 Google Antigravity AI 的模型配额使用量（Usage）与双重重置倒计时直接显示在 VS Code / Antigravity 编辑器的状态栏中。
🌟 Features / 核心特性
- ⚡ Dual-Window AI Quota Usage (双时间窗口配额使用量监控):
- 5-Hour Limit Usage: 5 小时滑动窗口使用量与独立重置倒计时（例如
5h 24% (4h 28m)）。
- Weekly Limit Usage: 周配额使用量与独立重置倒计时（例如
Wk 25% (2d 10h)）。
- 🔄 One-Click Toggle (点击即时切换模型系列):
- 点击状态栏，即可在 Gemini 系列 与 Claude / GPT 系列 之间一键无缝切换！
- Gemini View:
$(sparkle) 5h 24% (4h 28m) | Wk 25% (2d 10h)
- Claude & GPT View:
$(symbol-event)$(circuit-board) 5h 0% (4h 58m) | Wk 0% (6d 23h)
- 📊 Rich Markdown Tooltip (悬浮详细面板):
- 鼠标悬停在状态栏上，即可展开完整的 Gemini / Claude / GPT 配额看板、重置具体时刻及各模型明细。
- 🚥 Intelligent Threshold Alerts (智能预警颜色):
- 正常配额（Usage < 70%）：默认字体颜色
- 配额预警（Usage >= 70%）：黄色警告
- 配额告急（Usage >= 90%）：红色警报
- 🛡️ Zero External Traffic & Complete Privacy (纯本地环回，零外部流量):
- 仅通过本地环回接口（
127.0.0.1）与本地运行的 Antigravity 服务通信，不收集、不上传任何代码、聊天记录或个人数据。
🔒 Privacy & Security Audit / 隐私与安全合规说明
This extension has undergone strict security & privacy verification:
- No External Network Traffic (无外部网络请求):
- All HTTP requests are strictly bound to
127.0.0.1:<local_port> on the localhost loopback interface.
- Zero outbound requests to third-party servers, analytics platforms, or telemetry endpoints.
- No Code, Chat, or Workspace Inspection (不读取代码与聊天内容):
- The extension only requests quota summary metadata (
/RetrieveUserQuotaSummary and /GetUserStatus).
- It never accesses, reads, indexes, or modifies your workspace files, git history, or prompt messages.
- In-Memory Ephemeral Tokens (内存临时 Token，不落地存储):
- The local CSRF handshake token is kept in ephemeral process memory for local authentication only and is never written to disk or logged.
- Open Source & Transparent (开源透明):
- Complete source code licensed under the permissive MIT License.
⚙️ Configuration / 配置项
进入 VS Code 设置（Ctrl+, 或 Cmd+,），搜索 antigravityUsage：
| 设置项 (Setting) |
默认值 (Default) |
说明 (Description) |
antigravityUsage.displayMode |
"usage" |
展示模式："usage"（显示已使用量百分比）或 "remaining"（显示剩余量百分比） |
antigravityUsage.refreshInterval |
60 |
配额自动刷新周期（秒，范围 5~3600 秒） |
antigravityUsage.defaultFamily |
"gemini" |
启动时默认显示的模型系列 ("gemini" 或 "claude_gpt") |
antigravityUsage.statusBarPosition |
"right" |
状态栏显示位置 ("left" 或 "right") |
antigravityUsage.statusBarPriority |
100 |
状态栏显示优先级（数值越大越靠边缘） |
antigravityUsage.warningThreshold |
30 |
触发黄色警告的阈值百分比 |
antigravityUsage.criticalThreshold |
10 |
触发红色警告的阈值百分比 |
antigravityUsage.showResetTimeInStatusBar |
true |
是否在状态栏紧凑文本中显示独立重置倒计时 |
antigravityUsage.geminiIcon |
"$(sparkle)" |
Gemini 状态栏图标（支持任意 VS Code Codicon） |
antigravityUsage.claudeGptIcons |
"$(symbol-event)$(circuit-board)" |
Claude 与 GPT 状态栏图标（支持任意 VS Code Codicon） |
⌨️ Commands & Shortcuts / 快捷命令
- 切换视图：
Antigravity: Toggle Usage View (Gemini ⇄ Claude/GPT) (Ctrl+Alt+U / Cmd+Alt+U)
- 立即刷新：
Antigravity: Refresh Quota Data (Ctrl+Shift+U / Cmd+Shift+U)
- 查看配额详情面板：
Antigravity: Show Quota Breakdown
🛠️ Build from Source / 本地构建
git clone <repository_url>
cd vscode-antigravity-usage
npm install
npm run build
npx @vscode/vsce package
📄 License
MIT License. Copyright (c) 2026.
| |
