用途：把分散在不同 agent 中的“还剩多少、什么时候重置”汇总为一张只读体检表，涵盖官方订阅窗口额度、API 平台预付余额、本地网关真实消费，以及按当前强度还能用多久。适用于用户询问“查我的额度”“还有多少用量”“什么时候重置”或 how much quota is left 等场景，也可用于限流或余额见底前的提醒与定时巡检。
主要能力：每次运行输出统一结构，默认渲染为文本表，--json 输出机器可读版本。providers[] 含每个账号的 id、status（ok / expired / unavailable）、计划、窗口用量与重置时间或余额与币种；burn_rate 为可选，经 --watch 二次采样后给出每小时消耗与剩余可用天数；alerts[] 列出已用满窗口、低于阈值余额、未设置日/月限额的 provider。只读不变量：不刷新 token、不写入凭据、不打印密钥，缺失来源仅标记 unavailable 并给出补救提示。
使用方式：先确认 scripts/check_balance.py 与 references/providers.md 存在，解析 Profile（--profile 参数 → LOVSTUDIO_PROFILE → 共享 Profile 默认路径）。执行探测：python3 scripts/check_balance.py --gateway-log "$GATEWAY_LOG" --min-balance-cny "${MIN_BALANCE_CNY:-50}"；只查某类账号可用 --only codex、--only deepseek，可重复；需要结构化输出加 --json。需要速率时二次采样：python3 scripts/check_balance.py --watch 120 --json，采样窗口建议 ≥120 秒。汇报时交叉验证官方订阅与预付余额，口径冲突时同时列出。
适用场景与限制：适合额度查询、巡检与告警输入；不负责 API Key 管理轮换（交给 lov-env-management）、定时与通知（交给 lov-yoda-automation）、磁盘清理（交给 lov-clean-mac）或充值购买升级。依赖 Python 3.8+ 标准库，可选输入 macOS Keychain、~/.codex/auth.json、cc-switch SQLite、LiteLLM 请求日志；无第三方依赖，未配置来源按不可用处理。