VibeMeter项目深度解析：一款专业的AI服务消费监控工具

项目概述

VibeMeter是一款专为macOS设计的菜单栏应用程序，它采用多服务提供商架构，帮助用户监控多个AI服务商的月度消费情况。当前版本支持Cursor AI和Claude（通过本地日志文件分析），未来计划扩展支持OpenAI、GitHub Copilot等服务。

核心功能

1. 实时消费监控

• 可视化仪表盘：通过动画仪表盘图标直观显示消费情况
• 多服务商支持：同时监控多个AI服务的使用情况
• 消费限额提醒：可配置消费上限，达到阈值时发送系统通知

2. 技术架构

VibeMeter采用现代化的SwiftUI界面，基于以下技术架构：

多服务商架构

• ProviderProtocol：定义所有服务商必须实现的通用接口
• ServiceProvider枚举：标识支持的服务商类型
• ProviderFactory：根据服务类型创建实例
• ProviderRegistry：管理服务商的启用/禁用状态

关键架构模式

• 协调器模式：MultiProviderDataOrchestrator协调各专业管理器
• 组件化UI：StatusBarController委托给专业组件管理器
• Actor隔离：后台操作使用Actor保证线程安全
• 观察者模式：使用Swift的@Observable宏实现细粒度响应式更新

详细功能说明

1. 菜单栏显示

• 图标状态：
  • 未登录：灰色禁用状态
  • 加载中：蓝色渐变仪表盘带闪烁效果
  • 数据展示：根据消费百分比显示不同颜色（青色→绿色→黄色→橙色→红色）
• 文本显示：可选显示总消费金额

2. 弹出窗口内容

• 登录前：显示大仪表盘图标和"无连接服务商"提示
• 登录后：
  • 头部区域：用户头像和邮箱
  • 消费明细：按服务商显示消费详情
  • 底部操作：设置、刷新和退出按钮

3. 多服务商特性

• 支持同时连接多个服务商
• 聚合计算所有连接服务商的总消费
• 每个服务商维护独立的认证状态

4. 认证系统

• 每个服务商有独立的登录状态和窗口
• 使用LoginWebViewManager管理多个WKWebView实例
• 认证令牌安全存储在Keychain中

5. 数据获取

• 通用接口：定义获取团队信息、用户信息、月度账单等标准方法
• Cursor实现：具体实现Cursor API调用
• 数据协调：BackgroundDataProcessor在后台线程并发处理API调用

技术实现细节

1. 开发环境

• 操作系统：macOS 15.0+ (Sequoia)
• 架构：通用二进制(Apple Silicon & Intel)
• Swift版本：Swift 6（启用严格并发检查）

2. 核心组件

1. StatusBarController：管理NSStatusItem
2. MultiProviderDataOrchestrator：中央协调器
3. MultiProviderLoginManager：处理基于WebKit的认证
4. ExchangeRateManager：管理货币转换
5. SettingsManager：管理应用设置

3. 数据存储

• macOS Keychain：安全存储认证令牌
• UserDefaults：存储应用设置

4. 错误处理

• 网络错误、认证失败、API错误等都有专门处理
• 并发操作全部使用Swift并发机制

项目结构

VibeMeter/
├── App/                    # 应用入口
├── Core/                   # 核心代码
│   ├── Extensions/         # 扩展
│   ├── Models/             # 数据模型
│   ├── Protocols/          # 协议
│   ├── Providers/          # 服务商实现
│   ├── Services/           # 业务逻辑服务
│   └── Utilities/          # 工具类
└── Presentation/           # 表现层
    └── Components/         # 可重用UI组件

总结

VibeMeter是一款专业级的AI服务消费监控工具，其亮点在于：

1. 多服务商支持：可同时监控多个AI服务的使用情况
2. 实时可视化：通过动画仪表盘直观显示消费状态
3. 安全可靠：采用现代化Swift架构，保证数据安全和线程安全
4. 扩展性强：架构设计支持轻松添加新的服务商

对于经常使用多个AI服务的用户，VibeMeter是一款不可多得的实用工具，能有效帮助用户控制AI服务的使用成本。