CodexBar异步架构设计与多源数据采集实现：如何实时监控AI Token消耗

CodexBar异步架构设计与多源数据采集实现如何实时监控AI Token消耗【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBarCodexBar是一款专为开发者和产品经理设计的开源工具能够在无需手动登录的情况下实时监控OpenAI Codex、Claude Code等主流AI服务的Token消耗情况。通过创新的异步架构设计和多源数据采集策略它解决了传统监控工具数据延迟、资源占用高和隐私安全等问题为AI成本管理提供了专业级解决方案。技术挑战与系统设计传统AI服务监控面临三大技术挑战数据采集实时性不足、多源数据整合复杂、用户隐私保护困难。CodexBar采用模块化架构设计将系统划分为数据采集、处理、存储和展示四个核心层次通过异步任务调度和智能缓存机制实现高效数据流处理。图CodexBar模块化架构设计展示数据从采集到展示的完整流程核心架构模块系统主要包含五个核心模块Sources/CodexBarCore负责数据获取与解析Sources/CodexBar处理状态管理与UI交互Sources/CodexBarWidget提供WidgetKit扩展Sources/CodexBarCLI提供命令行接口以及Sources/CodexBarClaudeWatchdog确保Claude CLI会话的稳定性。异步数据采集机制多策略数据源整合CodexBar支持63种不同的AI服务提供商每种服务采用特定的数据采集策略。根据docs/providers.md文档主要采集方式包括Web爬取通过浏览器Cookie或WebView获取数据CLI接口通过RPC/PTY或提供商CLI工具获取OAuth认证使用OAuth API获取授权数据API令牌直接调用服务商API接口本地探测扫描本地会话文件获取使用数据// UsageStore.swift中的多源数据采集实现 func refresh(forceTokenUsage: Bool false) async { guard !self.isRefreshing else { return } self.isRefreshing true defer { self.isRefreshing false } await withTaskGroup(of: Void.self) { group in for provider in UsageProvider.allCases { group.addTask { await self.refreshProvider(provider) } group.addTask { await self.refreshStatus(provider) } } group.addTask { await self.refreshCreditsIfNeeded() } } }智能刷新策略系统采用自适应刷新策略根据用户交互模式和系统状态动态调整数据采集频率。如docs/refresh-loop.md所述刷新频率包括手动、1分钟、2分钟、5分钟、15分钟、30分钟以及自适应模式。图自适应刷新策略决策流程图根据系统状态动态调整采集频率数据处理与存储优化内存高效的状态管理UsageStore模块采用Swift 6严格并发模型通过Sendable状态和显式MainActor切换确保线程安全。数据存储在内存中避免频繁的磁盘I/O操作同时通过SettingsStore持久化用户配置。智能缓存机制Cookie和API凭证等敏感信息使用系统Keychain安全存储避免明文存储风险。Cookie导入支持多种浏览器包括Safari、Chrome/Chromium分支和Firefox确保跨浏览器兼容性。// Keychain安全存储实现 class KeychainCacheStore { private let service com.steipete.codexbar.cache func storeCookie(for account: String, cookie: Data, source: String) throws { let query: [String: Any] [ kSecClass as String: kSecClassGenericPassword, kSecAttrService as String: service, kSecAttrAccount as String: cookie.\(account), kSecValueData as String: cookie, kSecAttrAccessible as String: kSecAttrAccessibleAfterFirstUnlock ] // 安全存储实现 } }关键技术难点与解决方案多账户同步管理CodexBar支持同时监控多个AI服务账户如Claude的个人和工作账户。系统通过账户指纹识别和会话隔离确保数据准确性每个账户使用独立的WKWebsiteDataStore进行Web会话管理。图Claude多账户切换界面展示不同账户的资源使用状态实时数据一致性系统采用乐观并发控制机制通过isRefreshing标志防止重复刷新。当多个刷新请求同时到达时后续请求会被合并或延迟执行确保数据一致性同时避免资源浪费。错误恢复与降级策略当主要数据源不可用时系统自动降级到备用数据源。例如对于Codex服务采集策略按优先级顺序为OAuth API → CLI RPC → Web Dashboard。这种降级策略确保在部分服务故障时仍能提供基本功能。性能优化技术资源感知型调度AdaptiveRefreshPolicy模块根据系统状态智能调整刷新频率低电量模式或严重热压力30分钟刷新间隔最近5分钟内菜单交互2分钟刷新间隔最近5分钟内编码活动5分钟刷新间隔长时间闲置30分钟刷新间隔// AdaptiveRefreshPolicy.swift中的资源感知决策逻辑 func computeNextRefreshDelay(input: Input) - (delay: TimeInterval, reason: String) { if input.lowPowerModeEnabled || input.thermalState.isSeriousOrCritical { return (30 * 60, constrained) } if let lastMenuOpen input.lastMenuOpenAt, input.currentTime.timeIntervalSince(lastMenuOpen) 5 * 60 { return (2 * 60, recentInteraction) } // 更多条件判断... }本地会话扫描优化代理感知扫描通过LocalAgentSessionScanner每30秒检测本地编码活动但会严格控制资源使用最多处理64个代理进程最多解析128个Codex rollout元数据记录每个项目最多保留64个Claude会话候选共享512条目、深度1、150ms的元数据预算安全与隐私保护数据最小化原则CodexBar仅收集必要的使用统计数据不访问用户代码内容或敏感项目信息。所有数据在本地处理不上传到远程服务器。安全凭证管理API密钥和Cookie等敏感信息使用macOS Keychain安全存储支持自动和手动两种Cookie导入模式。手动模式允许用户直接从浏览器复制Cookie头部避免自动扫描的隐私顾虑。图系统Keychain权限设置界面确保敏感信息安全存储实际应用场景与技术集成开发环境集成开发团队可以将CodexBar集成到CI/CD流程中通过CLI接口获取使用统计数据# 获取当前使用情况 codexbar usage --provider codex --format json # 获取特定时间段的使用统计 codexbar usage --provider claude --days 7 --output csv成本监控仪表盘系统提供详细的成本分析仪表盘支持按订阅、模型和时间范围查看支出分布。如docs/screenshots/usage-spend-dashboard-maintainer-light.png所示界面清晰展示总支出、跟踪Token数量和订阅信息。图使用与支出仪表盘展示多服务成本分布和详细统计信息预警与通知系统当接近用量上限时系统会通过macOS通知中心发送预警。用户可以在偏好设置中配置预警阈值和通知方式确保及时了解资源使用情况。技术总结与扩展建议架构设计亮点模块化设计清晰的模块边界和职责分离便于维护和扩展异步处理充分利用Swift并发特性提高系统响应性多源适配支持多种数据采集策略提高系统鲁棒性资源感知智能调整资源使用优化系统性能扩展建议对于希望扩展CodexBar功能的开发者建议关注以下方向新增提供商支持参考现有提供商实现添加新的AI服务监控自定义数据源开发插件系统支持用户自定义数据采集逻辑高级分析功能添加趋势预测、异常检测等高级分析功能团队协作功能支持多用户数据聚合和团队级成本管理性能优化建议增量数据同步实现增量更新机制减少数据传输量智能缓存策略根据数据更新频率动态调整缓存时间并行处理优化进一步优化TaskGroup调度策略提高并发效率CodexBar通过创新的异步架构设计和多源数据采集策略为AI服务监控提供了专业级解决方案。其模块化设计、资源感知调度和安全隐私保护机制为同类工具的开发提供了宝贵的技术参考。无论是个人开发者还是企业团队都能通过CodexBar实现对AI资源使用的精细化管理优化成本支出并提高工作效率。要体验CodexBar的强大功能可以通过以下命令获取源码git clone https://gitcode.com/GitHub_Trending/co/CodexBar cd CodexBar make build【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考