安装

系统要求

• macOS 26 或更高版本
• 当前可下载 ZIP 需要 Apple Silicon
• 每个要使用的集成都需要相应本地工具或 Provider Session 已登录

Vibe Bar 是菜单栏应用。成功启动后会增加状态项，而不是打开普通应用窗口。

下载 Release

1. 从 GitHub Releases 下载 Apple Silicon ZIP。
2. 把 Vibe Bar.app 移到 /Applications。
3. 从「应用程序」或 Spotlight 启动。

首次启动

当前 Release 使用 ad-hoc 签名，尚未做 Apple Notarization。如果 Gatekeeper 拦截首次启动，请右键应用并选择打开。

在本机运行 Vibe Bar 不需要 Apple Developer 账号。

如果 macOS 仍拒绝打开，请确认 ZIP 来自官方 Release 页面，并查看 故障排查。

首次运行清单

1. 打开菜单栏状态项。
2. 打开 Settings，选择 Remaining 或 Used。
3. 只启用自己使用的核心与 Misc Provider。
4. 对每个核心 Provider 执行连接检查。
5. 设置刷新频率。
6. 打开 Cost Data，决定本地历史保留多久。

默认刷新频率是 10 分钟。Popover Open Refresh 与 Launch at Login 默认关闭。

更新

集成 Sparkle 的版本每天检查一次带签名的 GitHub Release 更新源。也可以从菜单栏 项目的右键菜单，或从设置 → 系统选择检查更新…。

安装更新前 Vibe Bar 始终会询问。首个集成 Sparkle 的版本仍需要手动安装一次， 之后的更新才可以使用应用内流程。

替换源码构建的旧版本前，先退出正在运行的实例，避免 macOS 继续保留旧 Executable。

添加远端 Linux 机器

先安装 macOS Core，再按远端探针下载独立 Linux 二进制、校验 SHA、避免把一次性纳管码写进 Shell History，并启用可回滚更新。 Probe 不开放入站端口，也不包含在 macOS App Bundle 里。

从源码构建

如果希望先检查源码再自行构建，请查看从源码构建。

移除应用

退出 Vibe Bar，然后把 /Applications 中的 Vibe Bar.app 移到废纸篓。

Vibe Bar 的设置和派生历史数据保存在 ~/.vibebar/。删除 App Bundle 不会 静默删除这些本地数据；手动处理前请先阅读 隐私与本地数据。

Vibe Bar 自己持有的 Cookie 与 Provider 凭据另外存放在 macOS Keychain。卸载前 如需一并清除，请先在对应 Provider Settings 页面删除已保存的 Cookie 或凭据。