Gitbar - macOS 状态栏 Git 贡献跟踪器

Gitbar 是一款精巧的 macOS 状态栏（菜单栏）应用程序，专门用于实时显示你的 GitHub 公开代码贡献统计数据。它基于广受欢迎的 BitBar 平台构建，致力于帮助你养成每日为开源社区做贡献的习惯。

🎯 核心功能

• 实时状态栏展示： 直接在 macOS 顶部菜单栏显示你的 GitHub 公开贡献数，一目了然。
• 贡献目标跟踪： 支持设置年度贡献目标（如 1000 次贡献），并计算完成百分比，激励你持续贡献。
• 简洁与详细视图切换： 通过 COMPACT_UI 设置，可以选择显示简洁的贡献计数或更详细的信息。
• 贡献连续记录（Streak）展示： 展示你的贡献连续天数，帮助你保持贡献动力。
• 专注公开贡献： 专门追踪并展示你 GitHub 个人主页上的公开仓库贡献，鼓励参与开源项目。

✨ 优势与特点

• 极简主义设计： 非侵入式设计，仅存在于状态栏，不占用额外屏幕空间，让你专注于工作。
• 低门槛使用： 无需生成复杂的 GitHub API Key，仅需提供 GitHub 用户名即可开始使用，设置简单快捷。
• 习惯养成工具： 通过常驻状态栏的视觉提醒，有效培养每日/定期为开源项目贡献代码的习惯。
• 基于 BitBar 生态： 作为 BitBar 的插件，继承了其轻量、稳定和高度可定制的特性。
• 开源透明： 项目本身采用 MIT 开源协议，代码公开，用户可以审查代码，也欢迎社区贡献。
• 隐私友好： 通过 gh-scrape 模块从公开页面抓取数据，只关注你愿意公开的贡献信息。

📦 系统要求与安装

1. 系统要求： macOS 10.6 (Snow Leopard) 或更高版本。
2. 必备环境： 需要安装 Node.js 和 npm。

安装步骤：

# 1. 克隆插件仓库

# 2. 进入仓库目录并安装依赖
$ cd gitbar
$ npm install

# 3. 配置你的 GitHub 用户名和目标
# 编辑根目录下的 `.env` 文件

配置 (.env 文件示例）：

GITHUB_USERNAME="你的GitHub用户名"
CONTRIBUTION_GOAL_TRACKING=true # 是否开启目标追踪
CONTRIBUTION_GOAL="1000"        # 你的年度贡献目标数
COMPACT_UI=true                 # 是否启用紧凑界面

4. 安装到 BitBar： 启动 BitBar 应用，在弹出的窗口中选择 gitbar 文件夹内的 gitbar_plugin 文件夹作为插件目录。

🔧 注意事项与高级设置

• Node 路径问题： 如果遇到 Node 路径错误，可能需要编辑 gitbar_plugin/gh.5m.js 文件顶部的 shebang (如 #!/usr/bin/env node)，将其指向你系统上正确的 node 路径。可以使用 which -a node 命令查找路径。
• 数据来源： 应用使用 gh-scrape 模块从 GitHub 公开个人主页抓取数据，而非官方 API。这使其专注于公开贡献，且避免了 API 密钥管理的麻烦。

Gitbar 是开发者保持开源参与度的完美小助手。它的存在就像一位沉默的伙伴，时刻在状态栏提醒你：“今天，你为开源世界添砖加瓦了吗？”