Tidy Usage Sidebar — Development skill for Claude Code

在 macOS 菜单栏常驻显示 Claude、Antigravity (Gemini)、DeepSeek 等 AI 平台的额度与余额。拒绝臃肿进程，只为抬头一瞥即知余量。

---

特性

• 菜单栏环形进度 & 余额 — 额度类服务显示 Logo 与 5/7 环形进度；DeepSeek 余额显示 Logo 与实时金额（如 ¥19）。≥ 80% 橙色预警，≥ 90% 红色警示（余额 < ¥5 橙色，< ¥1 红色），常态下单色融入系统菜单栏。
• 点击即时钉选 — 面板中点击任意行即可将该指标钉上 / 撤下菜单栏，未钉选行半透明弱化。未钉选任何指标时显示 gauge.with.needle 空状态。
• 原生毛玻璃面板 & 独立窗口 — 无边框 NSPanel 锚定菜单栏；同时支持独立主窗口，可自由拖拽、置顶常驻桌面，并支持隐藏 Dock 图标回到纯菜单栏模式。进度条下方显示自适应重置倒计时（< 24h 显示倒计时，≥ 24h 显示日期时间）。
• 零凭据风险 — 客户端向自建聚合端拉取脱敏数据，或直连官方 API（如 DeepSeek），Token / Key 均存入 macOS Keychain，无需写回明文配置。
• 相对更新时间 — 面板底部显示人性化更新时间（刚刚更新 / X 分钟前更新 / 昨天 HH:mm 更新），悬停可查看精确到秒的刷新时间与服务端取数时间。
• 429 容灾 & 离线缓存 — 上游 429 时保持上次成功数据，服务商不会闪退消失。磁盘持久化缓存，冷启动即刻展示历史用量。缺失服务商 30 秒后自动补拉。
• 防抖交互 — 刷新按钮整圈旋转不卡半截，退出二次确认，所有操作全面防抖节流。

---

快速上手

git clone https://github.com/RUIIIOVO/tidy-usage-sidebar.git
cd tidy-usage-sidebar

# 可选：配置 HTTP 例外域名
cp local.env.example local.env

# 编译 + 签名 + 安装至 ~/Applications 并启动
scripts/build.sh

首次启动后点击菜单栏图标 → 底部 ⚙️ 设置 → 填入自建查询接口地址和 Token → 保存并测试。

构建脚本自动检测 `Apple Development` 证书，无证书时回退 ad-hoc 签名。`local.env` 中配置 `HTTP_HOST` 可为指定域名打入 ATS 例外。

---

接口规范

客户端向自建端点发送请求：

GET /usage
Authorization: Bearer 

期望返回：

{