macOS menu bar tool to track Cursor spending
9 months ago
- #macos
- #menu-bar
- #swiftui
- 一款开源的 macOS 菜单栏应用，用于团队工作区使用和支出追踪。
- 功能包括登录、设置、自动刷新和分享能力。
- 采用模块化 Swift Package 架构，具有单向依赖关系：Core ← Model ← API ← Feature。
- 纯 SwiftUI MV 模式，强调清晰边界和可替换性。
- 菜单栏显示关键指标，点击弹出窗口查看详情。
- 登录和设置窗口支持凭证与偏好的持久化存储。
- 基于屏幕电源/活动状态的智能刷新策略。
- 内置字体和素材库便于生成可分享视图。
- 当前仅支持团队账户，欢迎贡献个人/免费账户兼容方案。
- 模块化设计允许通过PR集成其他数据源。
- 暂缺应用图标，欢迎设计师参与贡献。
- 品牌及数据源仅用于演示目的。
- UI层仅与服务协议交互，不涉及具体网络实现。
- 工作区包含多个职责明确的Swift Package。
- 核心规则：Core包放工具类，Model包放领域数据，API包处理网络I/O，Feature包实现UI。
- 严格遵循依赖方向：Core ← Model ← API ← Feature。
- SwiftUI MV模式使用@State/@Observable/@Environment/@Binding进行状态管理。
- 副作用通过.task/.onChange方法管理，支持生命周期感知的自动取消。
- 系统要求：macOS 14.0+、Xcode 15.4+、Tuist。
- 提供完整的安装配置指南。
- 测试方案：每个包独立测试，支持Xcode或命令行运行。
- 欢迎贡献代码，提供分支/提交/PR规范指引。
- 包含常见问题排查手册。
- 基于MIT协议开源。