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 架构。
📦 安装
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 及后续版本：
- 从最新 GitHub Release 下载
V2Bar-macOS-universal.zip。
- 解压 ZIP，将
V2Bar.app 移入“应用程序”文件夹。
- 从“应用程序”文件夹启动 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 可能阻止首次启动。
- 在 Finder 中按住 Control 点击或右键点击
V2Bar.app，选择打开，然后再次确认打开。
- 如果仍被阻止，请前往系统设置 → 隐私与安全性，找到 V2Bar 相关提示，点击仍要打开并确认。
仅当 App 来自本仓库的官方 GitHub Releases 且你信任该下载内容时，才应绕过 Gatekeeper。
🚀 使用说明
- 前往 V2EX 的 Token 设置页面 创建 Personal Access Token。
- 启动 V2Bar，点击菜单栏中的
V2，选择“设置 Token”。
- 输入 Token；验证通过后，菜单会加载账户资料与最近通知。
- 从通知分组查看回复、收藏和感谢，点击通知或“打开主题”跳转到 V2EX。
- 在“自动刷新”中选择打开菜单时刷新、每 5/15/30 分钟刷新或关闭。
- 可按需启用“登录时启动”；自
v0.2.0 起可使用“检查更新…”，并在后续版本发布后完成应用内升级。
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 等敏感信息。
评论