面向 Google Antigravity 2.0 桌面端 的零 Token 消耗本地监控插件
实时上下文占用环 · 精确缓存命中率 · 每日用量热力日历 · Gemini / Claude & GPT / Argon 额度监控
在日常高频使用 Google Antigravity 2.0 桌面端 时,经常需要同时关注两件事:
- 当前对话上下文还剩多少、缓存命中高不高?(防止上下文膨胀却浑然不知)
- Gemini 5h / 周额度、Claude & GPT 以及 Gemini 4 Argon 余量还剩多少?(不用反复点开左下角菜单)
本插件基于 Antigravity 官方 MCP Apps(SEP-1865) 与生命周期 Hooks 构建,完全在本地运行、不额外消耗任何模型 Token、无需安装第三方 Python/Node 依赖,支持暗色 / 浅色主题原生融合。
| 主面板 · 额度与会话上下文 | 展开详情 · 多模型额度与汇总 | 每日热力日历 · 模型分布 |
|---|---|---|
|
|
|
| Gemini 5h / 周限额、实时上下文环、 缓存命中率与 Token 明细 |
Claude & GPT、Argon 额度池、 今日 / 本月 / 累计用量与命中率 |
5 级每日用量热力日历、 单日明细与按模型用量分布 |
💡 点击任意截图可查看高清大图
- 所有刷新与同步工具均声明为
visibility: ["app"],对大模型完全不可见,面板刷新不占用对话上下文或模型额度。 - 纯 Python 标准库后端 + 单文件自包含 HTML 前端,无需
pip install或npm install。
- 完整对齐 Antigravity 原生
View Usage分组:- 外显常驻:
Gemini Models的 5h 限额 与 周限额(极简进度环 + 剩余百分比 + 重置倒计时 + 上次变动消耗 / 预计剩余轮数 / 节奏标签) - 点击展开:
Claude & GPT models(5h / 周限额)、Gemini 4 Argon(周限额)
- 外显常驻:
- 面板通过桌面端本机的
RetrieveUserQuotaSummary接口读取剩余百分比与重置时间,支持点击「同步」跳过缓存立即刷新;同时支持外部额度文件external_quota.json作为补充来源。 - 额度解析实现参考了 Antigravity Model Usage 与 CodexBar。
- 直接读取 Antigravity 本机
transcript.jsonl与conversation_summaries.db(只读),精确展示:- 上下文占用环 & 本轮净增:实时显示当前占比与本轮上下文净变化(如
本轮 +18.6K),客观呈现上下文增长趋势 - 上下文构成条:系统提示词与工具定义 / 对话消息与思考内容 / 工具输出与历史上下文的可视化占比
- 会话统计 & Token 用量明细:模型调用次数、对话轮数 / 工具调用次数、平均输出速率、缓存命中率(%)、未缓存输入、缓存读取、输出 Token,以及等效 API 美元价值与 Prompt Cache 节省金额
- 上下文占用环 & 本轮净增:实时显示当前占比与本轮上下文净变化(如
- 内置自定义暗色/浅色会话切换菜单,直接显示官方对话名称,默认自动跟随当前活跃会话,也可随时切换查看历史会话。
- 聚合本机全部历史会话,展示 今日 / 本月 / 累计 Token 用量、今日缓存命中率、今日 / 本月 / 累计等效 API 美元估值与缓存已省金额、按模型用量分布。
- 内置 5 级热力日历,支持翻月查看与点击任意日期查看当日精确明细。
- 右侧辅助栏(
aux_pane→额度与上下文):紧凑单列布局,可常驻在对话右侧边聊边看。 - 左侧导航栏(
global→用量与额度):宽屏双列仪表盘总览。 - 纯手动触发的一键原地更新:点击面板顶部下载图标即可手动查询最新 GitHub Release 并一键安全更新(自动备份旧版、失败自动回滚;纯前端改动直接热重载,平时零后台外联)。
.
├── plugin.json # Antigravity 插件清单
├── mcp_config.json # MCP Server 启动配置(使用 ${PLUGIN_ROOT} / ${PLUGIN_DATA})
├── hooks.json # 生命周期钩子(实时追踪活跃会话)
├── assets/
│ ├── logo.svg # 插件矢量图标
│ └── screenshots/ # README 界面截图
├── server/
│ ├── data_engine.py # transcript.jsonl 解析、汇总、日历与额度聚合
│ ├── live_quota.py # 读取桌面端本机余量和重置时间
│ ├── updater.py # 手动触发的安全原地更新模块(含备份与回滚)
│ ├── hook_tracker.py # Hook 轻量接收器(<50ms)
│ └── mcp_server.py # 纯 Python 标准库 MCP Apps Server(支持 --preview 预览)
├── ui/
│ └── app.html # 单文件自包含自适应交互界面
└── scripts/
├── install_plugin.ps1 # Windows 一键安装到 ~/.gemini/config/plugins/
└── test_local.py # 单元测试与 MCP 协议端到端测试
前置要求:本机已安装 Python 3.9+(且 python 命令在 PATH 中可用)。无需安装任何第三方包。
下载本仓库后,在项目根目录打开 PowerShell 运行:
powershell -ExecutionPolicy Bypass -File .\scripts\install_plugin.ps1脚本仅会把轻量插件文件复制到 ~/.gemini/config/plugins/antigravity-quota-monitor/,Antigravity 会自动发现并加载:
- 右侧辅助栏:展开右上角辅助栏 → 点击
+→ 选择 额度与上下文 - 左侧导航栏:在左侧插件菜单点击 用量与额度
将以下文件/目录复制到 ~/.gemini/config/plugins/antigravity-quota-monitor/:
plugin.json、mcp_config.json、hooks.json、assets/、server/、ui/。
提示:macOS / Linux 若系统仅提供
python3,请将mcp_config.json与hooks.json中的python改为python3。
python scripts/test_local.pypython server/mcp_server.py --preview 8765在浏览器访问 http://127.0.0.1:8765 即可直接预览本机真实数据与交互效果。
如需补充外部同步数据,可按以下标准 JSON 格式写入 ${PLUGIN_DATA}/external_quota.json(当桌面端未返回对应额度项且未过期时自动采用):
{
"updatedAt": "2026-11-22T06:30:00Z",
"buckets": {
"gemini_5h": { "remainingPct": 88, "resetsAt": "2026-11-22T10:48:00Z" },
"gemini_weekly": { "remainingPct": 90, "resetsAt": "2026-11-28T09:30:00Z" },
"claude_gpt_5h": { "remainingPct": 100 },
"claude_gpt_weekly": { "remainingPct": 92, "resetsAt": "2026-11-28T06:30:00Z" },
"argon_weekly": { "remainingPct": 100 }
}
}- 所有日志读取与额度查询均仅在本机回环(
127.0.0.1)与本地磁盘完成,不向任何第三方服务器发送数据。 - 会话令牌仅在内存中临时使用,不写入配置文件、不打印日志、不落盘。
- 面板偏好与活跃会话指针仅保存在 Antigravity 分配的
${PLUGIN_DATA}目录中,不会写入代码仓库。
- AI 协作开发:本项目由 Xieduuu 主导需求设计与验收,由 Google Gemini(Google Antigravity) 与 OpenAI GPT(Codex) 协作完成架构实现、界面打磨与额度同步优化。
- 开源参考:额度接口调用与解析实现参考了 DYY-Studio/antigravity-model-usage 与 steipete/CodexBar。
本项目基于 MIT License 开源。