AI Usage Widget

一屏看清 11 家 AI 服务的用量与配额 · 常驻桌面的小卡片

当前版本 0.16.0 · MIT License · Windows 10/11 · PowerShell + WinForms,零第三方依赖

下载最新版 安装说明 完整文档

AI Usage Widget 卡片界面(演示数据)

中文

卡片贴着桌面边缘常驻,每行一个供应商,显示已用百分比、窗口重置时间与趋势;悬停即可看到明细, 双击打开对应的官方用量页。数据全部来自你本机已有的登录凭证,不经过任何中转服务器。

支持的供应商

供应商显示内容凭证来源
GrokBuild / Chat 等产品的周用量与重置时间(多账号,每个账号一行)~/.grok/auth.json
Kimi5 小时窗与周窗口用量~/.kimi-code/credentials/kimi-code.json
ChatGPT / Codex5 小时窗与周窗口用量(多账号)~/.codex/auth.json
Gemini / Antigravity配额百分比与重置时间Windows 凭据管理器 gemini:antigravity
Command Code5 小时窗与周窗口用量,可选余额~/.commandcode/auth.json
OpenRouter密钥额度与上限(每个密钥一行)~/.openrouter/auth.json 或环境变量
DeepSeek账户余额与充值 / 赠额明细~/.deepseek/auth.json 或环境变量
Cline5 小时 / 周 / 月额度与重置时间(多账号,每个登记账号一行)~/.cline/data/settings/providers.json
Claude Code5 小时窗与周窗口用量~/.claude/.credentials.json
Cursor计费周期已用百分比与剩余额度Cursor 的 state.vscdb
GLM / Z.AI / 智谱 BigModelCoding Plan 的 5 小时窗与周窗口~/.zai、~/.zhipu、~/.bigmodel 或 ZCode 配置
GitHub CopilotPremium requests 已用占比与重置日期~/.config/github-copilot

主要能力

English

A small always-on-top card that docks to the edge of your desktop. One row per provider shows the used percentage, the window reset time and a trend line; hover for details and double-click to open the provider's own usage page. Everything is read from credentials already on your machine - nothing is proxied through a third-party server.

Providers

ProviderShowsCredential source
GrokWeekly usage and reset time (one row per account)~/.grok/auth.json
Kimi5-hour and weekly windows~/.kimi-code/credentials/kimi-code.json
ChatGPT / Codex5-hour and weekly windows (multi account)~/.codex/auth.json
Gemini / AntigravityQuota percentage and reset timeWindows Credential Manager gemini:antigravity
Command Code5-hour and weekly windows, optional balance~/.commandcode/auth.json
OpenRouterKey credit usage and limit (one row per key)~/.openrouter/auth.json or an environment variable
DeepSeekAccount balance and top-up detail~/.deepseek/auth.json or an environment variable
Cline5-hour / weekly / monthly quota and reset time (one row per registered account)~/.cline/data/settings/providers.json
Claude Code5-hour and weekly windows~/.claude/.credentials.json
CursorBilling period percentage and remaining creditCursor state.vscdb
GLM / Z.AI / Zhipu BigModelCoding Plan 5-hour and weekly windows~/.zai, ~/.zhipu, ~/.bigmodel or the ZCode config
GitHub CopilotPremium request percentage and reset date~/.config/github-copilot

Highlights

安装 / Install

仓库自带安装器,重复执行即为升级,不需要管理员权限:

git clone https://github.com/Regine88/ai-usage-widget
cd ai-usage-widget
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

常用参数:.\install.ps1 -Status 查看状态,.\install.ps1 -Uninstall 卸载, .\install.ps1 -Uninstall -Purge 连数据一起清掉。

也可以直接下载 Release 里的 zip 安装,或让 Scoop 管理:

.\install.ps1 -Zip .\ai-usage-widget-0.16.0.zip
scoop install https://github.com/Regine88/ai-usage-widget/releases/latest/download/ai-usage-widget.json

不想安装时,双击仓库里的 Start-AiUsageWidget.vbs 就能免安装运行; 想先看界面效果,用 -Demo 参数启动即可看到固定演示数据。

Light theme Tray menu English UI Trend window

配置 / Configuration

所有开关都在 ai-config.json,也可以在卡片右键「设置…」里改:刷新间隔、供应商开关、透明度、 阈值、静音时段、界面语言、窗口列数、每日汇总与分供应商阈值。配置文件与历史记录只写在本机, 发布包里不会包含任何个人数据。

{
  "intervalSeconds": 300,
  "columns": 2,
  "dailySummary": true,
  "providers": { "grok": true, "copilot": true }
}

文档 / Docs