Usage Toolbar
macOS 菜单栏常驻的国内大模型 API 用量监控工具
一个 macOS 菜单栏常驻工具,监控国内大模型 API 的余额与消耗趋势,本地积累数据并以折线图可视化。
自然时间生命线
按真实日期等比展开;短想法只占一小段,时间跨度越长越接近通栏。
这里会展示产品截图、概念稿或关键界面,用来补足文字之外的项目观感。
项目思考
国内大模型厂商的用量看板散落在多个后台,每个厂商的统计粒度、刷新频率、UI 体验都不一致,没有统一视图。Usage Toolbar 想做的是把多家厂商的余额和消耗聚合到菜单栏,让"今天烧了多少、还剩多少"成为一眼可见的信息。 三个核心决策:(1) 菜单栏常驻而非独立窗口——AI 用量是高频低时长信息,菜单栏比 Dock 应用更合适;(2) 余额快照差值法而非订阅 webhook——大多数国内厂商没有用量 webhook,差值法对厂商接口要求最低、适配最快;(3) Keychain 存 API Key + JSON 存快照——敏感凭据和长期数据分开,安全且可移植。
建设过程
Swift 6.3 + SwiftUI,目标 macOS 14+。MenuBarExtra (.window style) 承载主面板(TabView:总览 / 厂商列表 / 设置)。架构分层清晰:Models(AppState / Provider / BalanceSnapshot / ConsumptionRecord)、Services(ProviderProtocol / BigModelProvider / MiniMaxProvider / SnapshotStore / RefreshManager)、Views(MenuBarView / DashboardView / ProviderListView / SettingsView)、Utilities(KeychainManager / Constants)。SPM 构建,无需 Xcode。
当前进展
智谱(国内版 / 国际版)的余额查询和用量查询已完成,MiniMax 走逆向接口(待验证)。仪表盘、厂商列表、设置页、定时刷新调度、Keychain 存储和 JSON 本地存储均已实现。本地 MVP 可用,未上架 Mac App Store。