Profile
Back to NewsBack
GitHub Trending 1 min
Reader Mode
Lumidarin/agy-capsule: Context usage, model quotas, token breakdowns, and generation metrics — right in your Antigravity composer.

Lumidarin/agy-capsule: Context usage, model quotas, token breakdowns, and generation metrics — right in your Antigravity composer.

10 hours ago

agy-capsule

中文 | English

在 Antigravity 输入框底栏显示上下文占用、多模型配额、缓存状态和生成速度,悬停胶囊即可查看面板详情,点击胶囊即可固定面板。

依次悬停上下文、配额和请求失败胶囊(无鼠标),弹出对应面板

宣传片(v1.1,也可以在 B 站 观看):

https://github.com/user-attachments/assets/9f5bf1c6-1284-4e17-a380-defdee83f60c

想保留 1.0 的简约底栏,可以在侧栏设置关掉生成速度、最近请求、本轮统计、请求失败胶囊和服务器排队预警;如果只想看关键数字,还可以关掉上下文明细。

上下文

显示上下文占用、缓存命中率与缓存状态。上限按当前会话和模型实时读取。以下为可选项。

  • 缓存过期提醒:胶囊图标距上一轮默认满 3 分钟变黄、满 4 分钟变红 Cache 过期,右侧输入框可自定义变黄/变红分钟数(上限 998 / 999 分钟)。面板里的 Cache 行同步变化。
  • 上下文过载提醒:上下文超过 75% 时,胶囊数字变黄,超过 90% 时变红。
  • 生成速度:显示本轮最近一次请求的速度,每完成一次请求更新一次。
  • 速度动效:在模型生成回复时会闪烁的小圆点。在生成速度低于 10 tok/s 时红色,10 至低于 25 时黄色,25 及以上绿色。停下后保持颜色 15 秒再变灰。
  • 上下文明细:将上下文拆分成首轮、读取、思考、写入四个部分,分别显示数值和占比。可选横条显示或竖列显示。横条显示可选方块或圆点标记。竖列显示可逐项开关名称、数值、百分比,可自由调节顺序。
  • 最近请求:显示最近一次请求从首 token 到结束的耗时范围(如 4.5s–8.6s)和生成速度。
  • 本轮统计(默认关闭):显示本轮的耗时、请求数、思考和写入。

额度

显示当前或所有额度池的 5 小时与每周剩余额度和重置倒计时。

Vertex AI(Google Cloud 按量计费):当未返回套餐额度且 Antigravity 确认账号使用 Cloud 按量计费时,隐藏整个额度胶囊。

以下为可选项。

  • 突出当前模型:高亮当前所选模型所在的额度池,弱化其他池。
  • 隐藏不存在的配额窗口(默认开启):例如 AI Pro 用户的 Argon 池没有 5 小时额度,会被隐藏掉。

报错与排队预警

以下均为可选项,共用底栏第三胶囊(同时触发时优先显示请求失败):

  • 请求失败胶囊:仅在请求失败时弹出红色胶囊,悬停或点击后可在面板上查看原始报错和相关说明。提示原因包括:额度耗尽、限流(429)、断连、验证异常、服务繁忙、未知原因。
  • 服务器排队预警:在 Working 期间等待模型首字输出超过阈值(默认 30s,可在设置页末尾自定义 1–999s)时弹出黄色胶囊并实时计时;仅统计当前这一轮,多次超阈显示 ×N(如 排队×2 40s / 排队×2),悬停或点击可查看本轮各次超阈等待时长。本地工具执行中或已开始流式输出时不会误报。

语言和外观

  • 设置语言:English、简体中文、繁體中文。决定设置界面使用的语言。
  • 显示语言:English、简体中文、繁體中文。决定面板显示使用的语言。
两项语言设置只影响 agy-capsule 自己的界面,不会翻译 Antigravity 本身。
  • 面板高度:自然高度下各面板按内容决定,对齐高度让所有面板等高。
  • 面板间距:紧凑、标准、舒展。
  • 面板大小写:全小写、首字母大写。
  • 额度图形:圆圈、长条。
  • 缓存图形:图标、圆环、进度条。选择圆环或进度条后,面板的 Cache 行会随距上一轮的时间线性增长,依次变黄、变红,变红后保持满状态。
  • 重置倒计时:紧凑、本地化样式。

设置

在对话顶部 … → Extensions → agy-capsule 打开侧栏,顶部切换“统计”和“设置”两页。

设置保存在 ~/.gemini/config/agy-capsule/settings.json(Windows 为 %USERPROFILE%\.gemini\config\agy-capsule\settings.json),更新和卸载插件都不会覆盖;旧版本留下的文件缺少新选项时自动使用默认值。

安装

Windows

请按 Windows 安装指南 安装,里面包含下载、安装、底栏胶囊设置、更新、卸载和排查的全部步骤。

想让 AI 代装的话,把这句话发给 Antigravity:

请按 https://github.com/Lumidarin/agy-capsule/blob/main/docs/windows-install.md 帮我安装 agy-capsule。

macOS

请按 macOS 安装指南 安装,里面包含下载、安装、底栏胶囊设置、更新、卸载和排查的全部步骤。

不熟悉终端的话,把这句话发给 Antigravity,让它替你装:

请按 https://github.com/Lumidarin/agy-capsule/blob/main/docs/macos-install.md 帮我安装 agy-capsule。

Linux

在仓库目录运行 sh install.sh 安装,sh update.sh 更新(先拉取新版代码),sh uninstall.sh 卸载。插件装在 ~/.gemini/config/plugins/agy-capsule。装好后在 Plugins 面板启用。底栏胶囊需要用 --remote-debugging-port=0 参数启动 Antigravity。

常见问题

客户端更新后胶囊消失,需要重新更新 agy-capsule 吗?
不需要。 这是因为客户端更新后自行重启没有走带参数的快捷方式(或 macOS 的启动图标),只需完全退出 Antigravity 再从快捷方式重新打开即可恢复。如果之前已启用过底栏胶囊,插件会自动识别这一场景:在侧栏顶部提示「无需更新插件」(Windows 还会自动检测快捷方式参数是否被更新清除,支持一键补回),并可在设置中开启/关闭每次异常启动弹一次系统提醒(默认开启)。

数据口径

  • 生成速度 = 总输出 ÷(TTFT + 流式耗时),包含等待首 token 的时间。
  • 最近请求只看最近一次模型请求,不是整轮;缺失的数据显示 —。
  • 本轮统计从你最近一条消息开始累计,耗时包含排队、等待和工具执行。
  • 缓存过期提醒仅供参考:缓存状态(默认 3 分钟变黄 / 4 分钟过期,可在设置中调整)系根据距上一轮对话的时间间隔本地估算,实际命中情况以服务端为准。
  • 服务器排队预警:基于当前一轮已记录的请求首字等待(TTFT)以及运行中未处于工具执行或流式输出时的等待时长本地判断;新发送用户消息后自动归零。
详细说明

最近请求

  • 速度的分子是总输出,等于回复(含工具调用指令)加思考。计时不全或分母为零时,不计算速度。
  • TTFT 和流式耗时都取自 Antigravity 的记录,请求耗时是两者之和,不含工具执行。TTFT 的计时起点和首 token 的判定边界尚未确认,不能当作纯 prefill 耗时。
本轮统计
  • 从最近一条已发送的用户消息开始,包含排队时间;新消息重新累计。
  • 耗时用首尾时间相减,包含等待和工具;运行中本地计时,结束后固定,取消且缺少明确时间则显示未知。
  • 请求数包含已记录的重试,不含纯预检和注入回复,不保证覆盖未记录的后端调用。

开发测试

在仓库根目录运行 Node 测试,无需安装 Playwright:

node --test "test/*.test.mjs"

浏览器回归是可选的。装好 Playwright 和 Chromium 后,可单独运行 node test/browser-regressions.mjs。

贡献

欢迎提 Issue 和 PR,详见贡献指南。

声明

  1. 参考 @z21100644 (PR #1):感谢提供的多语言、部分面板视觉、点击固定面板、当前模型高亮、生成指标与速度动效、统一的 K / M token 数值格式、Cache 与配额悬浮说明、上下文过载提醒、请求错误分类,以及隐藏不存在的配额窗口等思路。工程上也参考了其样式隔离、SQLite 读取缓存、CDP 增量推送、安装维护和 Sidecar 自动重载,并按本项目结构重新实现。未引入七类上下文估算与附件扫描。本版另行设计了设置语言与显示语言分离、独立外观控制、请求失败胶囊、新底栏的折叠优先级、本轮统计及 Sidebar 交互。
  2. 参考 @Krwaby123 (PR #2):感谢报告网页翻译插件导致的配额面板溢出,并提出统一列对齐、让列宽适应长译文的修复思路。本版采用了不同的跨分组网格实现,并将百分比和倒计时标记为不翻译(可通过设置改为中文)。

License

MIT

Chat with me