Repository navigation
Releases
Releases · Regine88/ai-usage-widget
AI Usage Widget 0.16.0
Added
- Gemini、Kimi、Command Code、Claude、Cursor、GLM 与 GitHub Copilot 支持多账号。右键登记当前登录后,切换客户端里的账号再登记一次,卡片会为每个账号单独显示用量;令牌刷新写回该账号自己的快照。
ClineQuota.ps1+test-ClineQuota.ps1:解析 Cline Dashboard 的five_hour/weekly/monthly
配额窗口,主百分比取三者中的紧窗口,保留对应重置时间;同时解析~/.cline/data/settings/providers.json
里的 OAuth 凭证与过期时间。- Cline 供应商接入:复用 Cline CLI 登录态,支持登记多个账号并逐行显示各自限额,调用
/api/v1/users/me/plan/usage-limits;
access token 临近过期时按官方 CLI 契约刷新/api/v1/auth/refresh并原子写回原凭证文件。
登记时会区分新增账号和重复账号;CLI 仍返回已登记账号时用气泡提示先运行cline auth cline切换目标账号。
设置窗口、右键用量页、语言包、worker 注入、安装包清单和文档同步更新。 - 历史存储升级为 schema v2 与按月归档:记录供应商、账号、指标类型、窗口、周期、重置时间、原始值、
单位和采样状态;旧ai-history.jsonl双读并去重迁移到history\ai-history-YYYY-MM.jsonl。
默认保留 90 天,可通过historyRetentionDays/historyMaxBytes/historySampleMinutes
调整保留、容量和定时有效采样;不再按固定 2000 行截断。 - 余额、无上限和百分比指标分开处理:余额与无上限记录保留在原始 CSV,但不会伪造 0% 趋势;
预测只使用当前重置周期内的样本,少于三个样本时不给估算。 - 抓取调度改为静态供应商注册表加最多 3 个有界 runspace job;同一供应商不并发,完成的 job
立即应用,配置或账号变化后的旧 generation 结果会被丢弃。 - 错误退避区分认证、429、超时、解析和网络错误;失败行保留上次成功值、最近成功时刻和下次重试时间,
手动刷新可跳过退避。 - 新增集中账号管理面板,可设置别名、隐藏账号、调整顺序并移除本工具保存的快照;账号偏好统一写入
ai-config.json,同时继续兼容原有 Grok 别名文件。DPI 缩放变化时会重建字体和行布局。 - 单月报表导出支持选择月份和账号;账号过多导致窗口超过屏幕工作区时自动启用滚动。
Fixed
- Grok 账单接口的
productUsage包含不带usagePercent的可选产品(例如GrokChat)时,
不再导致整个账号读取失败;产品明细只展示实际提供百分比的项目。 - 多账号 OAuth 令牌刷新改为在文件锁内重读并核对账号身份,只更新 token 与过期时间字段。若刷新期间
外部客户端已切换到另一个账号,旧账号的结果写入自己的 DPAPI 快照,不再覆盖当前登录;Cline 和
Claude 也不再使用锁外读取的整份 JSON 覆盖凭证文件。 - 写回时进一步比较发起刷新时的 access / refresh 版本。同账号重新登录或另一个刷新先完成时,
迟到的旧结果会被丢弃;Cline、Claude 与 Gemini 的凭证保存失败会向上返回,不再只记日志后继续显示成功。
Changed
- 月度报表的
Change明确改为「百分点变化」;多月对比使用「月末百分点差」,避免把余额变化或
消费金额误解为百分比增长。
AI Usage Widget 0.14.0
历史报表与导出增强、发布包内容校验、GitHub Pages 落地页,外加智谱 BigModel(含 ZCode 凭证)并入 GLM 行。
Added
UsageReport.ps1+test-UsageReport.ps1:按天汇总(Get-UsageHistoryDailyRollup)、月度汇总
(Get-UsageHistoryMonthlySummary,复用Get-UsageTrendSlope算日均斜率)与月份清单,
并能渲染成 CSV / Markdown / HTML;HTML 自包含,不引用任何外部资源。- 右键菜单新增「导出历史」子菜单:原始采样 CSV、按天汇总 CSV、月度报表 Markdown、月度报表 HTML。
默认导出最近一个有数据的月份,没有历史时明确提示而不是生成空文件。 WidgetPackage.ps1+test-WidgetPackage.ps1+tools/verify-package.ps1:发布包内容校验——
期望清单与压缩包条目比对(缺文件 / 多余文件 / 数据与凭证文件)、包内版本号、.sha256一致性,
以及 Scoop manifest 的 version / hash / url / extract_dir / checkver / persist。- CI 新增
Package contentsjob;Release 工作流在打包之后增加Verify package contents步骤,
校验不通过就不发布。 site/+tools/build-site.ps1+test-SiteAssets.ps1+.github/workflows/pages.yml:
中英双语落地页,构建时注入版本号并复制截图,引用了不存在资源的页面会直接构建失败。- 智谱 BigModel 并入 GLM 行:新增凭证来源
~/.bigmodel/auth.json、$env:BIGMODEL_API_KEY
与 ZCode 的~/.zcode/v2/config.json(读builtin:bigmodel-coding-plan/builtin:bigmodel
的options.apiKey),中国站统一走open.bigmodel.cn。
Changed
- GLM 的凭证解析收敛成单一入口
Resolve-ZaiCredential(环境变量 > 凭证文件 > ZCode 配置),
移除Get-ZaiResolvedAuthPath/Get-ZaiEnvironmentKey/Get-ZaiResolvedBaseUrl三个旧函数。 - 服务端用
code != 0表达业务错误时(例如账号没开通 Coding Plan),该行改为提示
本地化的「该账号未开通 Coding Plan」,而不是笼统的「读取失败」。
Fixed
Compare-WidgetPackageEntries统一了仓库路径与压缩包条目的目录分隔符,子目录文件不再被误报为缺失或多余。Test-WidgetPackageVersionText的匹配模式改用[regex]::Escape拼接,不再被 PowerShell 变量插值破坏。
AI Usage Widget 0.13.0
第四个新供应商 GitHub Copilot,加上两块长期挂在路线图上的界面能力:多列布局与每日汇总。
Added
CopilotQuota.ps1:解析https://api.github.com/copilot_internal/user的quota_snapshots.premium_interactions,
优先进位用entitlement/remaining算已用百分比,缺计数时退回percent_remaining,unlimited记为 0%。
token 按 hosts.json → apps.json → OpenCodeauth.json的顺序深度优先查找,不绑定固定层级。columns(1 - 3):卡片可排成多列。WidgetLayout.ps1新增Get-WidgetLayoutRowAnchor,
Get-WidgetLayoutMetrics新增-Columns,Get-WidgetFormHeight改按行带折算高度;设置窗口新增「窗口列数」。dailySummary:每天固定时刻弹一次汇总气泡,日期写入ai-state.json的lastSummaryDate,同一天不会重复。providerAlertThresholds现在可以在设置窗口的多行文本框里直接编辑(kind=70,90,#起注释行,坏行忽略)。- 设置窗口新增 Copilot 开关,供应商复选框改成三列排布;右键「打开用量页」新增 Copilot 条目。
test-CopilotQuota.ps1/test-CopilotProvider.ps1:载荷换算、token 发现与 worker 注入的离线测试。
Changed
- 底部状态行的宽度改为跟随整张卡片,多列时不再只居中在第一列。
- 文档补充 Copilot 的凭证与接口说明,以及通义千问 / 豆包暂不接入的原因。
AI Usage Widget 0.12.0
三个新供应商:Claude Code、Cursor、GLM / Z.AI。没有本机凭证的行不会出现。
Added
ClaudeQuota.ps1:解析 Claude Code OAuth/api/oauth/usage的 5 小时 / 周窗口;凭证来自~/.claude/.credentials.json,过期时原地刷新。CursorQuota.ps1:从state.vscdb取出cursorAuth/accessToken(不依赖 sqlite 库),请求当前计费周期用量。ZaiQuota.ps1:GLM Coding Plan 的/api/monitor/usage/quota/limit(原始 API key,不加 Bearer)。~/.zai/auth.json走api.z.ai,~/.zhipu/auth.json或ZHIPU_API_KEY走open.bigmodel.cn。- 设置窗口、右键「打开用量页」、语言包、HTTPS 主机白名单同步这三家。
AI Usage Widget 0.11.1
让 PSScriptAnalyzer 的 Error 门禁真正能绿:修掉自动变量名冲突,并标明 DPAPI 包装不是明文密码。
Fixed
Write-ModelRequestEvent/Record-ModelRequest.ps1的参数名$Error与 PowerShell 只读自动变量冲突。ConvertTo-SnapshotCipherText对ConvertTo-SecureString -AsPlainText加上抑制说明:这是当前用户 DPAPI 包装快照 JSON,不是口令。
AI Usage Widget 0.11.0
工程收口:把布局和文案抽成可测模块,修刷新间隔被状态文件盖掉的回归,并补上锁定位置与紧凑布局。
Added
WidgetLayout.ps1+test-WidgetLayout.ps1:full / compact 两套 96-DPI 设计像素,主程序只负责把窗口 DPI 换成 Scale。WidgetFormat.ps1+test-WidgetFormat.ps1:百分比、余额主数值、重置时间、抓取错误与耗尽预测文案。- 锁定位置:设置窗口与右键菜单均可开关,锁定后仍可双击打开用量页。
- 紧凑布局:行高约减半并隐藏明细行,适合供应商较多时少占屏幕。
- 额度重置提醒:已用百分比从高位掉到低位时弹一次气泡(仍尊重静音时段);
providerAlertThresholds可在ai-config.json里按供应商覆盖全局阈值。 Assert-TrustedHttpsHost:所有Invoke-WidgetRest请求先校验 https 与主机白名单,允许 path/query(Grok billing 的?format=credits)。install.ps1 -Zip在旁边存在.sha256时校验哈希。
Fixed
- 右键菜单改过刷新间隔后,设置面板里保存的间隔会在重启时被
ai-state.json盖掉:现在配置文件是权威源,两处写入保持同步。 - 切换浅色主题后页脚时间戳仍用深色
Dim。 - OpenRouter 空密钥会让
Substring抛错,整张卡片停止刷新。 - 上一实例崩溃留下的遗弃互斥体会让新实例无法启动。
- 状态栏启动失败文案不再贴原始异常。
Changed
- GitHub 仓库描述 / topics 补上 OpenRouter 与 DeepSeek;Release 正文优先使用 CHANGELOG 对应章节。
- PSScriptAnalyzer 的 Error 级发现会让 CI 失败;Warning 仍只报告。
- 日志脱敏额外折叠
sk-/sk-or-v1-形态的密钥。
AI Usage Widget 0.10.0
第 7 个供应商 DeepSeek(余额型)与深色 / 浅色双主题;同时修复「ai-config.json 从未真正生效」的回归。
Added
- DeepSeek 余额行(
ApiKeyAuth.ps1共用)与浅色主题(WidgetPalette.ps1) - 启动参数
-Theme dark|light,只覆盖本次运行
Fixed
ai-config.json读取后又被$script:Config = $null清掉,刷新间隔、不透明度和语言全部失效
完整说明见 CHANGELOG 的 0.10.0 章节。
AI Usage Widget 0.9.0
Full Changelog: v0.8.0...v0.9.0
AI Usage Widget 0.8.0
Full Changelog: v0.7.0...v0.8.0
AI Usage Widget 0.7.0
Full Changelog: v0.6.0...v0.7.0