设置参考
点击 Vibe Bar Popover 顶部的齿轮按钮打开设置。左侧栏包含应用级页面、核心 Provider 和每一个 Misc Provider 实例；条目较多时可以直接用搜索框过滤。
系统与刷新
| 设置 | 可选项 | 默认值 | 作用 |
|---|---|---|---|
| Percent shows | Remaining / Used | Remaining | 切换整个界面的百分比与预测措辞。 |
| Refresh every | 1、3、5、10 或 30 分钟 | 10 分钟 | 设置定时刷新配额的频率。 |
| Refresh when the popover opens | 开 / 关 | 关 | 每次打开 Popover 时尝试取得新数据。 |
| Minimum open-refresh cooldown | 1、2、5 或 10 分钟 | 1 分钟 | 避免频繁开关 Popover 导致重复请求 Provider。 |
| Launch at login | 开 / 关 | 关 | 把 Vibe Bar 注册为 macOS 登录项。 |
打开 Popover 触发的刷新只作用于可见 Provider，而且不会快于所选冷却时间。 Provider 仍可能拒绝或延迟请求；请结合 Last updated 与连接健康状态确认新数据是否 真正落地。
Updates 会显示当前版本并提供手动检查。集成 Sparkle 的 Release 每天检查一次 签名后的 GitHub Release Feed，但安装更新前始终需要确认。
菜单栏
Menu Bar → Overview 同时控制状态项和 Popover：
- Show in menu bar：显示或隐藏状态项。
- Show title text：增加简短的
VB标签。 - Layout：Icon Only、Single line、Two rows 或 Compact。
- Display density：Compact、Regular 或 Spacious。
- Fields：选择直接显示在状态项中的配额 Bucket。
- 每个选中字段都可以设置更短的自定义标签。
字段列表会随 Provider 能力变化。除主要的 5 小时与周额度外，还可以包含 Codex Spark、Claude 模型限制、Gemini Web、AntiGravity 和 Grok Credits 等 Plan 或 模型分支。如果 Provider 暂时不再返回某个 Bucket，配置仍会保留，并可在之后刷新 成功时重新出现。
迷你窗口
迷你窗口是一块独立悬浮的配额界面。
- 选择 Regular 或 Compact。
- 勾选这一模式要显示的字段。
- 按需修改字段标签与分组标签。
- 从 Popover 顶部打开迷你窗口。
Regular 与 Compact 各自保存一套字段。双击迷你窗口可在两种模式之间切换。 Vibe Bar 还会记住窗口上次是否打开以及最后的屏幕位置。
Misc Provider 不进入迷你窗口；这里仅显示有独立详情页的 ChatGPT/Codex、 Claude、Gemini/AntiGravity 与 Grok 配额。
核心 Provider
核心 Provider 条目可以拖动排序。隐藏 Provider 会移除它在 Overview 中的卡片、 Totals 贡献、状态块与 Tab，但不会删除凭据、刷新配置或历史数据。
每个 Provider 页面包含：
- 可选的 Plan 标签覆盖；留空则使用自动检测结果；
- 存在多条数据路径时的 Source 选择；
- 支持时提供浏览器 Cookie 导入或 WebView 登录；
- 各路径健康状态与手动连接检查。
具体顺序与配置步骤见核心 Provider。
Misc Provider 与多账号
每个 Misc 条目包含显隐复选框、拖动手柄、配置控件、Clone 按钮，以及 Clone 实例上的删除按钮。
- 隐藏只把卡片从 Misc Tab 移走，配置与凭据仍保留。
- Clone 会创建同一种 Provider 的独立实例。
- 可以把实例命名为
Work、Personal等。 - 每个实例分别保存凭据、Cookie Slot、配额缓存与设置。
- 删除 Clone 会清除该实例保存的凭据与配额缓存。
部分 Cookie Provider 可以在同一实例中增加多个 Cookie Slot。新增 Slot 不会 覆盖旧 Slot，Vibe Bar 会对这些账号的配额取平均。完整配置映射见 Misc Provider。
Cost Data
Vibe Bar 根据受支持的本地 CLI Session 记录估算成本，不包含 Web 或桌面聊天。
| 设置 | 可选项 | 默认值 |
|---|---|---|
| Keep history | Forever、30 天、90 天、1 年、3 年 | Forever |
| Privacy mode | 开 / 关 | 关 |
保留期限同时作用于成本历史和订阅填充历史。Rescan cost logs 会重新扫描受支持 的本地记录。Clear cost data 会删除派生历史、Snapshot 与扫描缓存，但不会 删除 Provider 自己的 CLI Session 文件。
Privacy Mode 会清除这些派生成本文件，并在开启期间停止把成本数据写入磁盘。 配额设置与 Provider 凭据不受这个开关影响。详见 成本与预测和 隐私与本地数据。
设置保存在哪里
不敏感的偏好写在 ~/.vibebar/settings.json。Vibe Bar 自己持有的凭据、API Key、OAuth Token 与导入的 Cookie 则保存在 macOS Keychain 中。一般不建议手改 settings.json；未知或无效值可能在下次启动时被标准化。