V2Bar

一款原生 macOS 菜单栏工具，快速查看 V2EX 账户信息与最近通知。

🖼️ 截图预览

✨ 功能亮点

• 连接 V2EX 账户。 设置 Personal Access Token 后先验证有效性，再读取账户资料、Token 有效期和头像；Token 可随时更换或移除。
• 集中查看最近通知。 将最近通知按主题聚合，区分回复、收藏、感谢和其他事件，并可直接打开相关主题或用户主页。
• 快速访问常用页面。 从菜单栏直达 V2EX 首页、时间轴、创建主题、通知和个人设置。
• 按自己的节奏刷新。 默认在打开菜单时刷新，也可选择每 5、15、30 分钟刷新或关闭自动刷新。
• 融入日常使用。 支持登录时启动，并在菜单栏中显示账户刷新状态；自 v0.2.0 起提供 Sparkle 更新入口，用于检查后续版本。

🪶 原生与轻量

• 原生菜单栏体验。 V2Bar 使用 Swift、SwiftUI 和 The Composable Architecture（TCA）构建，基于 MenuBarExtra 与 LSUIElement 运行，不包含 Electron 运行时或嵌入式 WebView。
• 只保留必要状态。 Token 和自动刷新设置通过 macOS 本地存储保存；账户、头像与通知数据从 V2EX 获取，不依赖本项目自建服务端。
• 跟随系统外观。 界面使用原生 SwiftUI 菜单控件，自动适配 macOS 浅色与暗色模式。
• 同时支持新旧 Mac。 Release workflow 使用 Xcode 26.5 构建，并验证发布产物同时包含 arm64 与 x86_64 架构。

📦 安装

Important

v0.1.1 及更早版本使用历史 DMG，系统要求和功能与本文描述可能不同。自 v0.2.0 起，V2Bar 提供 Universal ZIP、Sparkle appcast 和 Artifact Attestation；历史 DMG Release 会继续保留。

系统要求

• macOS 14 Sonoma 或更高版本
• Apple Silicon 或 Intel Mac（Universal Binary）

Homebrew

brew trust 命令首次随 Homebrew 5.1.15 发布。在 Homebrew 5.1.15–5.x 中，只有启用 HOMEBREW_REQUIRE_TAP_TRUST=1 时才会要求信任；从 Homebrew 6.0.0 开始，默认要求显式信任非官方 tap 中的 cask。

brew tap ygsgdbd/tap
brew trust --cask ygsgdbd/tap/v2bar
brew install --cask v2bar

上述命令只信任 v2bar cask，不会信任整个 tap；信任记录通常只需设置一次。详情请参阅 Homebrew 官方的 Tap Trust 文档。

Homebrew 5.1.14 及更早版本没有 brew trust，也不需要执行该命令：

brew tap ygsgdbd/tap
brew install --cask v2bar

如果执行 brew trust 时出现 Unknown command: trust，请跳过该命令，或先运行 brew update 升级 Homebrew。

更新 Homebrew 安装版：

brew upgrade v2bar

如果 Homebrew 提示 Refusing to load cask ... from untrusted tap，请先执行：

brew trust --cask ygsgdbd/tap/v2bar

然后重新运行安装或升级命令。如果已有安装在升级 Homebrew 后无法更新，也请先信任该 cask，再重试 brew upgrade v2bar。

手动安装

v0.1.1 及更早版本使用 DMG：从对应 GitHub Release 下载 V2Bar.dmg，打开后将 V2Bar.app 拖入“应用程序”文件夹。

v0.2.0 及后续版本：

1. 从最新 GitHub Release 下载 V2Bar-macOS-universal.zip。
2. 解压 ZIP，将 V2Bar.app 移入“应用程序”文件夹。
3. 从“应用程序”文件夹启动 V2Bar。

验证发布来源

从 v0.2.0 开始，可安装 GitHub CLI 后验证 GitHub Actions 生成的 Artifact Attestation：

gh attestation verify V2Bar-macOS-universal.zip --repo ygsgdbd/V2Bar

SHA-256 校验值同时发布在对应 Release 的 checksums.txt 中。Artifact Attestation、Sparkle EdDSA 与 SHA-256 用于验证来源和完整性，但不能替代 Developer ID 签名或 Apple notarization。

首次启动与 Gatekeeper

V2Bar 的 GitHub Release 没有 Developer ID 签名，也没有经过 notarization（公证），macOS 可能阻止首次启动。

1. 在 Finder 中按住 Control 点击或右键点击 V2Bar.app，选择打开，然后再次确认打开。
2. 如果仍被阻止，请前往系统设置 → 隐私与安全性，找到 V2Bar 相关提示，点击仍要打开并确认。

仅当 App 来自本仓库的官方 GitHub Releases 且你信任该下载内容时，才应绕过 Gatekeeper。

🚀 使用说明

1. 前往 V2EX 的 Token 设置页面 创建 Personal Access Token。
2. 启动 V2Bar，点击菜单栏中的 V2，选择“设置 Token”。
3. 输入 Token；验证通过后，菜单会加载账户资料与最近通知。
4. 从通知分组查看回复、收藏和感谢，点击通知或“打开主题”跳转到 V2EX。
5. 在“自动刷新”中选择打开菜单时刷新、每 5/15/30 分钟刷新或关闭。
6. 可按需启用“登录时启动”；自 v0.2.0 起可使用“检查更新…”，并在后续版本发布后完成应用内升级。

Note

Personal Access Token 会保存在当前 Mac 上。请妥善保管，不要将其粘贴到 Issue、日志或截图中。

🧪 开发与测试

项目使用 Tuist 管理 Xcode 工程，源码目标为 macOS 14.0+、Swift 5.9；Release workflow 使用 Xcode 26.5。

brew install just tuist
git clone https://github.com/ygsgdbd/V2Bar.git
cd V2Bar
tuist generate --no-open
open V2Bar.xcworkspace

运行与发布 workflow 一致的测试：

just check

测试覆盖账户刷新、Token 验证、通知聚合、自动刷新、登录项、系统操作、模型解析和 README 截图配置。

正式发布必须先通过 PR 合入受保护的 main，在 CHANGELOG.md 中准备对应版本段，然后创建并推送 annotated tag：

git tag -a vX.Y.Z -m "V2Bar vX.Y.Z"
git push origin vX.Y.Z

如需重跑已有 tag 的发布 workflow，必须从同一个 tag ref 发起：

gh workflow run release.yml --ref vX.Y.Z -f release_tag=vX.Y.Z

带后缀的 annotated tag（例如 vX.Y.Z-beta.1）会发布为 prerelease，并跳过 Homebrew cask 更新。

如需重新生成 README 截图，请先安装 ImageMagick 与 rtk，为终端授予“屏幕与系统音频录制”和“辅助功能”权限，退出其他 V2Bar 实例后执行：

./script/generate_readme_screenshots.sh
./script/validate_readme_screenshots.sh

💬 问题反馈

如果遇到问题或有功能建议，请提交 Issue。反馈问题时请附上 macOS 版本、V2Bar 版本和可复现步骤，并注意移除 Token 等敏感信息。