开源mac原生AI Coding菜单栏工具：集成用量统计与开发调试功能

背景

这款 macOS 原生 AI Coding 菜单栏工具的开发初衷，源于开发者在建筑设计领域转向 AI 辅助编程时的实际需求。作者最初受到小红书上一款名为 claude statistics 的小工具启发，该工具仅具备查看 Token 实时用量的基础功能。作为 Coding 新手，作者认为 Token 的使用量能提供一种直观的正反馈，因此希望量化自己每天使用 AI 的频率和深度。

然而，作者在尝试了市面上现有的几款同类工具后，对它们的界面设计和审美体验并不满意。出于对 UI/UX 的高标准要求以及对自己量化统计需求的强烈渴望，作者决定从零开始开发一款属于自己的原生应用。该项目已完全开源，并在 LINUX DO 社区进行了推广，旨在为 macOS 用户提供一个集统计、开发辅助和社区阅读于一体的高效工具。

核心内容

该工具不仅仅是一个简单的 Token 计数器，而是一个随着开发过程不断迭代、功能日益丰富的 macOS 原生应用。其核心功能模块涵盖了从数据监控到开发环境管理的多个维度：

1. Token 用量统计 这是应用的基础功能，以菜单栏扩展（Menu Bar Extra）的形式存在，实时显示当前的预估 Token 消耗。这一功能旨在为 AI 编码用户提供即时的量化反馈，帮助用户感知自己的 AI 使用强度。

2. Git 追踪与统计 在开发过程中，作者发现 Git 在 AI 编码工作流中的重要性。因此，应用加入了 Git 追踪功能，并提供了多种维度的统计视图：

• Git Graph：可视化的提交历史。
• 活跃度分析：统计不同 AI 模型在 Git 提交中的活跃度。
• 重合度分析：对比 AI 生成的代码与 GitHub 实际提交的重合度，帮助开发者评估 AI 辅助编程的实际贡献率。

3. AI Activity 专注度分析 受 tyme 这款时间追踪工具中“休息统计”功能的启发，作者引入了“AI Activity”概念。该模块通过分析 IDE 在前台的时间与 Session 的活跃时间，来反映用户每天在多大程度上使用了 AI。虽然单日统计可能存在误差，但长期来看，它能有效反映用户在使用 AI 辅助编程时的专注程度变化趋势。应用提供了日视图和周视图两种展示方式。

4. 交互界面的演进：从 Menu Bar 到 Floating Bar

• 初始方案：仅使用标准的 macOS 菜单栏扩展。
• 痛点：用户反馈有时难以在复杂的菜单栏中找到该图标。
• 迭代方案：放弃了类似 Bartender 那样重组菜单栏的复杂方案，转而采用吸附在屏幕四周的 Floating Bar（浮动栏）。当鼠标悬停时，浮动面板会自动展开，展示了 Codex 和 Claude 等不同模型的实时状态，既解决了查找困难的问题，又保持了界面的整洁。

5. 主界面与综合仪表盘 为了解决菜单栏信息密度低、展示范围有限的问题，应用开发了独立的主界面。主要功能包括：

• 用量与状态监控：直观展示 Claude 和 Codex 的剩余 Token 用量，以及 API Status 状态。当 Status 出现异常时，系统会发出通知。
• 排行榜功能：基于隐私保护考虑，数据通过 CloudKit 上传（默认关闭），用户可选择加入排行榜，查看他人的 Token 消耗量及历史趋势，形成社区互动。

6. 开发环境辅助工具 针对 Coding 过程中遇到的真实痛点，应用集成了多项实用小工具：

• 端口管理：解决本地多项目运行时端口混淆的问题，支持一键关闭端口，无需记忆命令行。
• Homebrew 包管理：提供直观的界面进行包管理，避免版本冲突和环境混乱。
• 开发环境检测：自动检查开发环境配置，降低新手配置环境的门槛。
• Network 调试：提供浏览器 F12 开发者工具之外的备选网络调试方案，目前仍在完善中。

7. 杂项功能与社区集成

• Skills 与 Configs 统计：对 AI 使用的 Skills（技能/提示词模板）和 Configs（配置文件）进行分类统计和下载，方便用户管理和复用。
• Plans 统计：记录模型编写的 Plan（计划/思路），便于在模型出错时回溯之前的思考路径。
• LINUX DO 阅读器：将 LINUX DO 社区的内容集成到 App 中，方便开发者在编码间隙快速阅读社区动态，目前 UI 仍在优化中。

关键要点

• 原生体验优先：应用为 macOS 原生开发，注重 UI 审美和交互流畅度，解决了现有工具界面简陋的问题。
• 功能迭代逻辑清晰：从单一的 Token 统计，扩展到 Git 分析、专注度追踪，再到开发环境辅助和社区集成，每一步都源于开发者的真实痛点。
• 隐私与数据透明：排行榜数据使用 CloudKit 上传且默认关闭，尊重用户隐私；项目完全开源，无隐藏代码。
• 交互创新：采用 Floating Bar 替代传统 Menu Bar，解决了图标隐藏和查找困难的问题，提升了操作效率。
• 全链路辅助：不仅关注 AI 用量，还覆盖了从代码提交（Git）、环境配置（Homebrew/端口）、网络调试到知识管理（Skills/Plans）的完整 AI 编码工作流。
• 社区驱动：深度集成 LINUX DO 社区，体现了开发者对开源社区文化的认同和参与。

意义与影响

这款工具的出现，标志着 macOS 上的 AI 编码辅助生态正在从单一的“功能型”工具向“综合型”工作流平台演进。

首先，它填补了市场在高审美、原生体验类 AI 统计工具上的空白。许多现有工具功能强大但界面粗糙，该应用通过优秀的 UI 设计和流畅的交互，提升了开发者使用 AI 辅助编程的愉悦感。

其次，它提供了多维度的量化视角。除了传统的 Token 消耗，它还引入了“AI Activity”专注度统计和 Git 重合度分析，帮助开发者更科学地评估 AI 辅助编程的效率和质量，而不仅仅是关注成本。

最后，它将社区文化与开发工具深度融合。通过内置 LINUX DO 阅读器，它不仅仅是一个工具，更成为了一个连接开发者社区的入口，促进了开源社区内的知识共享和技术交流。对于 macOS 开发者而言，这是一款值得尝试的、能够显著提升 AI 编码效率和体验的开源利器。