Vibe Bar

简体中文

English

简体中文

English

外观

故障排查 ​

先确认三个事实：Provider 当前显示的错误、Last updated 时间，以及 Settings 中 的连接健康检查。保留的旧值不等于本次刷新成功。

首次启动被 macOS 阻止 ​

当前 Release 使用 ad-hoc 签名且尚未 Notarize。先把应用移动到 /Applications，然后按住 Control 点击或右键 Vibe Bar.app，选择打开。

自己构建的 Bundle 仍被标记为 Quarantine 时：

bash
xattr -d com.apple.quarantine ".build/Vibe Bar.app"

只对自己构建或从 Vibe Bar 官方 Release 页面下载的 Bundle 执行此命令。

菜单栏没有出现图标 ​

  1. 在 Activity Monitor 确认 Vibe Bar 正在运行。
  2. 如果能打开 Settings，检查 Menu Bar → Show in menu bar。
  3. 给 macOS 菜单栏留出空间；空间不足时系统会隐藏部分状态项。
  4. 退出所有重复的 Vibe Bar 进程，只重新打开一份。

Vibe Bar 是菜单栏应用，启动时不会打开普通主窗口。

核心 Provider 提示需要登录 ​

打开对应 Provider 的 Settings 页面并执行连接检查：

  • ChatGPT/Codex：先登录 Codex CLI，再把浏览器导入或 OpenAI WebView 登录 作为回退。
  • Claude：先登录 Claude Code，再尝试浏览器导入或 Claude WebView 登录。
  • Gemini：在受支持浏览器登录 gemini.google.com 并导入 Cookie；仅登录 CLI 不会提供实时 Gemini 配额。
  • AntiGravity：保持本地 AntiGravity Language Server 运行。
  • Grok：运行 grok login，或导入已登录 grok.com 的浏览器 Session。

可以临时选择固定 Source 隔离故障路径；配置健康后再切回 Auto。

  1. 先在浏览器中登录 Provider。
  2. 保持持有该 Session 的 Browser Profile 可用。
  3. 重试 Import from browser。
  4. Provider 支持时改用 Sign in via Web。
  5. 最后才使用手动 Cookie Header 输入框。

浏览器安全机制与 Cookie Schema 会变化。尤其是 Xiaomi MiMo，新版 Chrome 加密 阻止直接导入时应使用内置 Web 登录。短效的腾讯与火山引擎 Session 也可能只是 需要重新登录。

寻求帮助时不要贴出复制的 Cookie Header。

数字陈旧或刷新失败 ​

  • 点击一次刷新并等待 Provider 请求完成。
  • 对比刷新前后的 Last updated。
  • 执行 Provider 的连接检查。
  • 查看 Provider Status 卡片是否存在服务事故。
  • 如果账号刚换 Plan，清空 Plan Label Override 后重新刷新。
  • 只重新认证被标记为 Missing 或 Failed 的路径。

刷新失败后保留 Last known good Snapshot 是预期行为；判断数据新鲜度以当前错误 和时间戳为准。

成本历史为空或明显偏低 ​

成本历史需要受支持的本地 CLI 记录，不包含 Web 与桌面聊天。

  1. 确认预期的本地 Session 目录存在。
  2. 确认 Privacy Mode 已关闭。
  3. 选择 Settings → Cost Data → Rescan cost logs。
  4. 确认 Retention 仍覆盖缺失日期。
  5. 不完整或不支持的模型元数据可能被跳过。

成本是估算值。Grok 对 Session Total 使用混合价格，AntiGravity 不受支持的 CLI-only Container 也不会被扫描。

Forecast 一直处于 Learning ​

新安装、新发现的 Bucket 或清空历史后出现 Learning 都很正常。保持定时刷新，让 观测覆盖更多重置周期。Confidence 需要足够覆盖、新鲜 Sample，以及最好有多个 可比较的已完成周期。

Remaining 与 Used 只改变显示方式，不改变底层预测。

旧版本中所有 Provider 都显示未登录 ​

早期沙箱版本可能留下影子 Home：

bash
ls ~/Library/Containers/com.astroqore.VibeBar/Data/ 2>&1

当前 Vibe Bar 不启用沙箱，应使用真实 Home。如果这个旧 Container 存在，并且 包含陈旧的 .codex、.claude 或 .vibebar 数据，请退出 Vibe Bar，先备份你 有意放入其中的内容，再移除过时的 com.astroqore.VibeBar Container 并重启。

这个清理只针对 Legacy Sandbox Container 症状。不要删除真实的 ~/.codex、 ~/.claude 或 ~/.vibebar。

构建失败 ​

Xcode 路径不正确 ​

bash
sudo xcode-select -s /Applications/Xcode.app
xcode-select -p
swift --version

项目要求 macOS 26+、Xcode 26 与 Swift 6.2+。

验证打包后的 App ​

bash
./Scripts/build_app.sh release
codesign --verify --deep --strict ".build/Vibe Bar.app"
codesign -d --entitlements - ".build/Vibe Bar.app"

Entitlement 输出不能包含 com.apple.security.app-sandbox。

收集安全的诊断信息 ​

可以安全提供：

  • Vibe Bar 版本与 macOS 版本；
  • Provider 名称与所选 Source Mode；
  • 已脱敏错误文本；
  • Last updated 时间；
  • 连接健康状态；
  • 预期本地路径是否存在；
  • 可以复现问题的步骤。

绝不要附上 Token、Cookie、JWT、Keychain Value、完整 Auth 文件、个人邮箱、 Organization ID 或未脱敏的 Session Log。

问题仍存在时，可以在 GitHub Issues中搜索或提交，并 附上上述安全证据。

基于 AGPL-3.0-only 许可证发布。

Copyright © 2026 AstroQore