KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

V2Bar

★ 20 Open GitHub ↗

A sleek and elegant macOS menu bar application, providing you with quick access to V2EX. 一个简洁优雅的 macOS 菜单栏应用，为你提供快捷的 V2EX 访问体验

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">一款原生 macOS 菜单栏工具，快速查看 V2EX 账户信息与最近通知。</p>

## 🖼️ 截图预览

![V2Bar 浅色模式菜单](https://raw.githubusercontent.com/ygsgdbd/V2Bar/main/Screenshots/preview-light.png)

![V2Bar 暗色模式菜单](https://raw.githubusercontent.com/ygsgdbd/V2Bar/main/Screenshots/preview-dark.png)

## ✨ 功能亮点

- **连接 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。

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

上述命令只信任 `v2bar` cask，不会信任整个 tap；信任记录通常只需设置一次。详情请参阅 Homebrew 官方的 [Tap Trust 文档](https://docs.brew.sh/Tap-Trust)。

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

```bash
brew tap ygsgdbd/tap
brew install --cask v2bar
```

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

更新 Homebrew 安装版：

```bash
brew upgrade v2bar
```

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

```bash
brew trust --cask ygsgdbd/tap/v2bar
```

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

### 手动安装

`v0.1.1` 及更早版本使用 DMG：从对应 [GitHub Release](https://github.com/ygsgdbd/V2Bar/releases/tag/v0.1.1) 下载 `V2Bar.dmg`，打开后将 `V2Bar.app` 拖入“应用程序”文件夹。

`v0.2.0` 及后续版本：

1. 从[最新 GitHub Release](https://github.com/ygsgdbd/V2Bar/releases/latest) 下载 `V2Bar-macOS-universal.zip`。
2. 解压 ZIP，将 `V2Bar.app` 移入“应用程序”文件夹。
3. 从“应用程序”文件夹启动 V2Bar。

### 验证发布来源

从 `v0.2.0` 开始，可安装 [GitHub CLI](https://cli.github.com/) 后验证 GitHub Actions 生成的 Artifact Attestation：

```bash
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 设置页面](https://www.v2ex.com/settings/tokens) 创建 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](https://tuist.dev/) 管理 Xcode 工程，源码目标为 macOS 14.0+、Swift 5.9；Release workflow 使用 Xcode 26.5。

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

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

```bash
just check
```

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

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

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

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

```bash
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 实例后执行：

```bash
./script/generate_readme_screenshots.sh
./script/validate_readme_screenshots.sh
```

## 💬 问题反馈

如果遇到问题或有功能建议，请提交 [Issue](https://github.com/ygsgdbd/V2Bar/issues)。反馈问题时请附上 macOS 版本、V2Bar 版本和可复现步骤，并注意移除 Token 等敏感信息。

V2Bar

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README