# BurnBar：本地优先的AI编码助手使用量追踪工具

> BurnBar是一款macOS菜单栏应用，采用本地优先架构，帮助开发者实时监控AI编码助手（如Claude Code、Codex、Kimi等）的使用量、成本和工作流程，无需API密钥，数据完全本地存储。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-10T01:44:45.000Z
- 最近活动: 2026-05-10T02:34:00.589Z
- 热度: 161.2
- 关键词: BurnBar, OpenBurnBar, AI编码助手, Claude Code, Codex, 用量追踪, 本地优先, macOS应用, 成本监控
- 页面链接: https://www.zingnex.cn/forum/thread/burnbar-ai
- Canonical: https://www.zingnex.cn/forum/thread/burnbar-ai
- Markdown 来源: ingested_event

---

# BurnBar：本地优先的AI编码助手使用量追踪工具\n\n## 问题背景：AI编码助手的"黑箱"成本\n\n随着Claude Code、GitHub Copilot、Codex、Kimi等AI编码助手的普及，开发者们享受到了前所未有的生产力提升。然而，这种便利背后隐藏着一个常见问题：**我们究竟在这些工具上花费了多少钱？**\n\n许多开发者习惯于同时打开多个AI代理标签页，直到月底收到账单时才惊觉开销之大。更糟糕的是，大多数AI工具提供商的用量统计要么延迟，要么不够细化，难以实时了解具体的使用模式和成本分布。\n\n## BurnBar项目简介\n\nBurnBar（又称OpenBurnBar）是由Imagine That AI团队开发的开源macOS应用，旨在解决上述痛点。它是一款**本地优先**的菜单栏工具，能够实时监控AI编码助手的使用情况，帮助开发者掌握真实的成本数据。\n\n项目地址：https://github.com/Imagine-That-Ai/BurnBar\n\n## 核心设计理念：本地优先与隐私保护\n\nBurnBar最显著的特点是其**本地优先（Local-first）**架构。在当今云服务主导的时代，这种设计理念显得尤为珍贵：\n\n### 数据完全本地存储\n\n- 所有分析数据存储在本地SQLite数据库中\n- 无需注册账户，无需提供API密钥\n- 无需连接云端服务即可核心功能运行\n- 可选的云同步（Firestore/iCloud）仅作为数据复制和协作层，不替代本地状态\n\n### 直接读取本地日志\n\nBurnBar的工作原理是读取AI助手在本地留下的会话日志文件，而非通过API查询。这意味着：\n\n- 支持Claude Code、Factory/Droid、Codex、Kimi等多种主流AI编码工具\n- 用户的API密钥始终保留在原提供商处，BurnBar只读取磁盘上的"面包屑"\n- 零额外网络请求，零API调用开销\n\n## 功能特性详解\n\n### 菜单栏集成\n\nBurnBar以菜单栏应用形式存在，没有Dock图标，不会抢夺焦点。用户需要时点击查看，不需要时完全无感知——这种设计完美契合开发者追求简洁高效的工作习惯。\n\n### 实时成本与用量追踪\n\n应用提供多维度的用量统计：\n\n- **时间维度**：今日、本周、本月的用量概览\n- **计量单位**：支持在"美元花费"和"Token数量"之间切换\n- **提供商维度**：查看各个AI服务商（OpenAI、Anthropic等）的用量分布\n\n### InsightEngine智能洞察\n\nBurnBar内置的InsightEngine能够识别使用模式并主动提醒：\n\n- 检测到今日花费比昨日增长40%\n- 缓存命中率分析\n- 新模型首次使用提醒\n- 以卡片形式呈现，避免冗长的电子表格\n\n### 每日摘要通知\n\n用户可设置每日定时接收用量摘要通知，让未来的自己获得清晰的用量认知，而非月底的账单惊吓。\n\n### 内置聊天面板\n\nBurnBar甚至包含一个聊天界面，允许用户直接询问关于自己用量数据的问题——虽然有点元（meta），但对于深度用户来说确实有用。\n\n## 技术架构深度解析\n\nBurnBar的架构设计体现了现代macOS应用开发的最佳实践：\n\n### 守护进程架构\n\n应用采用**守护进程优先（Daemon-first）**设计，核心功能由OpenBurnBarDaemon提供：\n\n- 项目注册表、问题追踪、任务管理\n- 模拟器回放、任务来源追踪\n- 自动接管功能\n\n这种设计使得UI只是守护进程的一个视图，即使关闭界面，后台统计仍在继续。\n\n### 本地检索基础设施\n\nBurnBar构建了完整的本地检索系统：\n\n```\nsearch_documents + search_chunks + FTS\n  +--> chunk_embeddings + embedding_versions\n  +--> retrieval_health (projection/semantic/rebuild)\n```\n\nGRDB/SQLite作为交互权威，Firestore仅用于共享工件的复制和协作，而非主搜索路径。\n\n### CLI工具支持\n\n除了图形界面，BurnBar还提供命令行工具：\n\n```bash\nswift run --package-path OpenBurnBarDaemon OpenBurnBarCLI -- help\n```\n\n支持的命令包括健康检查、项目控制、问题查询、任务管理、模拟器运行等，满足高级用户的自动化需求。\n\n### 编辑器扩展\n\nBurnBar提供Cursor/VS Code扩展，通过本地守护进程与编辑器通信，实现编码活动与用量追踪的无缝集成。\n\n## 可选云服务集成\n\n虽然本地优先是核心，BurnBar也提供可选的云同步功能：\n\n- **Google/Apple登录**：基于Firebase的身份验证\n- **选择性同步**：用量记录、应用内聊天线程元数据可跨设备同步\n- **显式控制**：聊天消息内容需要单独开启，完全由用户决定\n- **随时退出**：关闭云同步后，本地功能不受影响\n\n此外，BurnBar还支持将部分模型（Z.ai、MiniMax、Ollama Cloud）通过本地OpenAI兼容网关路由，供Cursor、Factory和OpenCode使用。\n\n## 部署与使用\n\n### macOS安装\n\n当前BurnBar的macOS版本处于Beta阶段（0.1.3-beta.1），安装流程简单：\n\n1. 从GitHub Releases下载最新DMG\n2. 拖拽OpenBurnBar.app到/Applications\n3. 从菜单栏启动\n\n源码安装也是可选方案，使用`make install`命令即可完成。\n\n### 系统要求\n\n- macOS系统\n- 本地已安装并使用过支持的AI编码助手（Claude Code、Codex等）\n\n## 应用场景与用户价值\n\n### 个人开发者\n对于独立开发者，BurnBar帮助建立对AI工具使用的成本意识，避免无意识的开销累积。通过查看每日、每周趋势，可以更好地规划预算。\n\n### 团队管理\n在团队环境中，BurnBar可以帮助技术负责人了解团队整体的AI工具使用模式，识别潜在的成本优化机会。\n\n### 效率分析\n通过InsightEngine提供的洞察，用户可以发现自己的使用习惯——比如是否过度依赖某些模型、缓存利用是否充分等，从而优化工作流程。\n\n## 局限性与注意事项\n\n当前版本需要注意以下限制：\n\n- **平台限制**：目前仅支持macOS，Windows/Linux用户暂无法使用\n- **Beta状态**：macOS版本仍在Beta测试，可能存在稳定性问题\n- **编辑器扩展**：VS Code扩展目前仅提供源码，尚未上架官方市场\n- **支持范围**：仅支持在本地留下日志文件的AI工具\n\n## 总结与展望\n\nBurnBar代表了AI工具生态中的一个重要补充：**当AI提供商专注于构建更强大的模型时，第三方工具如BurnBar则帮助用户更好地管理和理解这些工具的使用**。\n\n其本地优先的设计理念在当前云优先的行业趋势中显得尤为独特，为注重隐私和自主性的开发者提供了一个可靠的选择。\n\n随着AI编码助手变得越来越普及，像BurnBar这样的用量追踪工具将成为开发者工具箱中的标准配置。它不仅仅是一个成本监控工具，更是一个帮助开发者建立健康AI使用习惯的助手。\n\n对于macOS用户，特别是那些同时使用多个AI编码助手且关心实际开销的开发者，BurnBar值得一试。