UsageBoard：macOS开源菜单栏工具，一站式监控AI大模型与搜索API配额消耗

一、UsageBoard是什么

UsageBoard是一款基于Swift开发、适配macOS 13.0及以上系统的开源菜单栏轻量工具，开源协议为MIT。软件采用Python插件化架构，核心作用是聚合各类AI大模型、搜索服务、代理流量API的账户配额与消耗数据，无需登录各平台网页后台，直接在Mac顶部菜单栏实时查看Token消耗、账户余额、调用次数、额度重置倒计时等信息。

软件分为主程序与独立插件两部分，主程序负责界面渲染、配置存储、定时调度，各类服务商的数据查询逻辑全部封装为独立Python插件，本地存储API密钥与用量缓存，所有敏感数据仅保存在本机，无云端上传行为。内置智谱GLM、DeepSeek、Claude、MiniMax、Tavily等主流服务商插件，同时支持用户自行开发自定义插件扩展监控渠道。

二、软件核心功能

1. 常驻Mac菜单栏快速交互
   软件安装后常驻系统顶部菜单栏，点击图标即可唤起监控窗口，提供标签页、分组两种数据展示模式；支持全局一键刷新所有API数据，也能单独刷新单个服务商卡片。系统休眠时自动暂停数据拉取，设备唤醒后恢复定时刷新，减少资源占用。

2. 可视化用量数据展示
   内置多重数据可视化组件，进度条支持百分比、数字双显示模式，可自定义进度条配色；自带7天、15天、30天Token消耗折线趋势图，能够拆分不同模型单独统计消耗；额度即将用尽时进度条标红预警，同时展示额度重置倒计时；付费订阅账户可显示PRO、PLUS等级徽章，API查询失败会直接在卡片展示自定义错误文本。

3. 插件化扩展管理系统
   所有服务商监控能力由独立Python插件实现，插件可单独开启/关闭、自定义刷新间隔、填写专属API密钥；软件启动时自动复制内置插件至用户本地插件目录，设置界面会自动读取插件脚本注释，动态生成密钥输入框、下拉选项、文件夹选择框等配置表单，无需修改主程序即可新增监控渠道。

4. 本地持久化缓存机制
   用量数据统一缓存在本地states文件夹，重启软件后可直接加载上次缓存数据，无需重复拉取接口；全局配置、插件参数、密钥信息统一存储在本地config.json文件，全程本地存储，不对外传输密钥信息。

5. 完整个性化设置功能
   支持中英文界面切换、开机自启、插件拖拽排序、在线版本更新、插件帮助文档查看，可统一调整全局数据刷新周期，批量管理所有插件启用状态。

三、软件特色优势

多服务商覆盖对比

1. 一站式聚合监控
   不用频繁打开多个服务商网页后台，单一软件统一查看全部API用量，大幅节省查询时间，适合同时使用多款AI接口的开发者、自媒体创作者。

2. 轻量化原生Mac应用
   基于Swift原生开发，资源占用极低，仅以菜单栏小程序形式运行，无多余弹窗与后台冗余进程，适配Mac休眠、唤醒等系统机制，续航友好。

3. 本地数据安全优先
   API密钥、账户用量全部存储本机，无云端同步、无第三方数据上传，不存在密钥泄露风险，适合存放高权限API密钥。

4. 高度自定义可扩展
   标准化Python插件开发规范，有基础编程能力即可快速编写私有服务商插件，适配企业内部API、小众AI服务。

5. 完全开源免费可商用
   采用MIT开源协议，个人、企业均可免费使用、修改源码、二次分发，无功能阉割、无强制付费弹窗。

四、使用方法

1. 安装步骤

方式一：Homebrew一键安装
打开终端，依次执行两行命令：

brew tap marsmay/usageboard
brew install --cask usageboard

若系统弹出安全拦截，终端执行解除隔离命令：

xattr -cr /Applications/UsageBoard.app

方式二：本地源码构建

1. 克隆项目GitHub仓库至本地；

2. 终端执行swift build完成调试构建；

3. 运行打包脚本bash scripts/build.sh生成可安装App程序。

2. 基础使用流程

1. 打开UsageBoard，软件自动常驻顶部菜单栏；

2. 点击菜单栏图标打开主窗口，进入设置页面；

3. 在插件列表中启用需要监控的服务商，填写对应平台获取的API密钥；

4. 自定义插件刷新周期、界面语言、展示模式；

5. 返回主界面，自动拉取用量数据，实时查看额度、消耗趋势。

3. 自定义插件开发

1. 在本地插件目录~/Library/Application Support/UsageBoard/plugins/新建Python脚本；

2. 在脚本头部注释填写插件元数据，定义名称、图标、配置表单；

3. 调用项目内置_common.py公共工具封装请求、翻译逻辑；

4. 脚本标准输出规范JSON格式用量数据，stderr输出调试日志；

5. 将插件在软件内启用，即可正常监控对应服务商API。

五、收费价格

UsageBoard为完全开源免费工具，无任何付费功能、无订阅套餐、无广告、无付费解锁限制。

源码公开可自由下载、编译、商用，开发者可自行修改源码二次分发，无需支付授权费用。

六、常见问题解答

Q1：UsageBoard支持哪些系统？

A1：软件仅支持macOS系统，系统最低版本要求macOS 13.0及以上，Windows、Linux系统暂无适配版本。

Q2：填写的API密钥会上传到第三方服务器吗？

A2：不会，所有密钥、用量数据仅保存在本机config.json与缓存文件夹中，软件仅本地调用服务商官方接口，不存在数据云端上传行为。

Q3：插件查询API显示报错该如何处理？

A3：首先核对API密钥是否填写正确，确认服务商账户未欠费、额度未清零；其次检查插件刷新间隔设置，缩短刷新周期重试；若接口服务商维护，等待恢复后重新刷新。

Q4：如何添加软件未内置的AI服务商监控？

A4：可按照项目Python插件开发规范，自行编写独立插件脚本放入本地插件目录，在软件内启用后即可实现自定义监控。

Q5：软件如何开启开机自动启动？

A5：打开软件设置页面，找到开机自启选项勾选保存，重启电脑后软件会自动运行并常驻菜单栏。

Q6：更新版本需要重新配置所有插件密钥吗？

A6：不需要，全局配置与插件参数统一本地持久化存储，在线更新软件不会清空本地配置文件。

七、相关链接

• GitHub仓库地址：https://github.com/marsmay/UsageBoard

八、总结

UsageBoard是专为macOS用户打造的开源轻量化API用量监控菜单栏工具，依托灵活的Python插件架构实现多平台AI接口配额统一查看，兼顾原生系统流畅体验与本地数据安全，无任何收费门槛，同时开放插件开发能力满足个性化监控需求，是高频使用各类大模型、搜索API人群高效管理账户额度的实用工具。

UsageBoard下载地址