快速开始
这份指南会带你从下载 Release 走到看懂第一个总览。
系统要求
- macOS 26 或更高版本
- 使用当前可下载 Release 时，需要 Apple Silicon Mac
- 你希望查看的集成需要已经存在对应的本地 Provider 或 Coding Agent 数据
如果要从源码构建，还需要 Xcode 26 与 Swift 6.2 或更高版本。
1. 安装应用
下载最新 Release，把 Vibe Bar.app 移到 /Applications，然后启动。关于 Gatekeeper 和更新方式，参见安装。
2. 打开菜单栏仪表盘
点击 macOS 菜单栏中的 Vibe Bar 状态项。总览会把额度预测、成本摘要、模型排行 与服务状态收进同一个界面。
Vibe Bar 会读取支持的本地输入并刷新 Provider 数据，不会把陈旧数据伪装成 刷新成功。刷新失败时，错误会保持可见，同时仍可查看最后一次成功快照。
3. 连接 Provider
打开 Settings，对每一个使用的核心 Provider 执行连接检查。日常推荐使用 Auto：
- Codex 与 Claude 可以复用本地 CLI 凭据以及可选 Web Session。
- Gemini 实时配额需要导入
gemini.google.comCookie。 - AntiGravity 需要本地 Language Server 正在运行。
- Grok 可以复用
grok login写入的~/.grok/auth.json。
需要额外 Plan 时，从 Misc Provider 列表启用并配置。Token 或 Cookie 只能粘贴到 对应的安全设置输入框。
4. 选择信息密度
完整总览适合日常查看。希望把所有有效额度固定在第二块屏幕，或悬浮在全屏 工作区上方时，可以打开迷你窗口。
迷你窗口有两种布局：
- Regular 保留更大的仪表展示。
- Compact 用更小的占地显示同一套额度模型。
5. 检查设置
设置中可以：
- 在 Remaining 与 Used 百分比之间切换；
- 定时刷新，或在打开 Popover 时刷新；
- 设置 Open-refresh 冷却时间；
- 配置开机启动；
- 控制 Provider 显隐和排序；
- 设置本地成本数据保留期，或清除派生成本数据。
默认设置为 Remaining、每 10 分钟定时刷新、Regular Popover Density 与无限期 保留历史。Popover Open Refresh、Launch at Login 与 Privacy Mode 默认关闭。