RepoBar 使用指南：先查 GitHub 待办，再看本地分支

上班先打开几个仓库的 Issues、PR、Actions，再去终端看本地分支，很容易把第一轮检查变成来回切窗口。RepoBar 的用处，是先把远端待办和本地检出状态摆在同一个菜单里，帮你决定先处理哪个仓库。它不替你审查代码。

本文依据官方文档与发行记录整理，核验日期为 2026-10-19；没有安装实测，也不承诺节省了多少时间。当前核对版本为 0.10.2。这是仍在维护的小众工具，不是新上线的产品。

从一轮仓库检查开始

起点是几份需要维护的 GitHub 仓库，以及 Mac 上已有的项目目录。目标产出不是“全部处理完”，而是一份明确的处理顺序：哪里 CI 异常、哪里有待看的 PR、哪个本地工作区还留着修改。

1. 从 OpenNavo 应用页了解安装条件，或到官方发行页下载。打开应用后，选择 Sign in to GitHub，完成浏览器登录。
2. 进入 Preferences → Repositories，将当天需要看的仓库设为 Visible 或 Pinned，不相关的设为 Hidden。先缩小第一轮检查范围，而不是把所有项目都展开。
3. 从菜单查看 Issues、PR、CI 和 Releases，再进入具体仓库的子菜单。数字是入口，不是严重程度判断；真正的优先级还要读问题和 CI 日志。
4. 在 Preferences → Advanced → Local Projects 选择项目根目录。匹配后，检查 branch、upstream、ahead/behind、dirty files 和 worktrees，再用 Open in Finder 或 Open in Terminal 进入项目。
5. 有本地修改、分支分叉或状态不明时，先停在检查阶段。不要因为菜单里有 Sync、Rebase、Reset 就随手执行。

图为官方仓库提供的历史示例，展开的是 steipete/summarize；仓库版本标记不是 RepoBar 应用版本，图中相对时间也不是当前数据。图片所示应用构建未知。

本地关联有两处容易误判

官方 Local Projects 文档说明，扫描默认深入四层，跳过隐藏目录和符号链接。匹配优先看目录名与仓库名，再参考 origin。多个组织有同名仓库时，建议自己核对远端和路径，不把自动匹配当成确认。显示零个仓库时，也应检查扫描深度和选定目录权限；文档提到书签失效后可能需要重新选择文件夹。

Git 的“领先/落后”依赖已获取的上游引用，不是持续联网的真相。RepoBar 的本地发现和状态也有缓存。准备修改或同步之前，查看获取时间；关键操作仍回到 Git、CI 日志与实际 diff。

自动同步应当是第二步

先用状态展示，再考虑是否启用 Auto-sync clean repos。官方规则要求工作区干净、不是 detached HEAD、落后于远端，而且只能 fast-forward。Git 官方说明，fast-forward-only 在分支分叉时会失败，而不是替你合并。

这个边界能减少意外丢改动的风险，但不等于完全只读：同步会获取并更新符合条件的本地分支。如果你希望项目目录完全不被后台修改，就保持自动同步关闭。文档还说明，手动 Sync、Rebase、Reset 在 fetch 失败后应停止；这不是建议你试运行 Reset。

缓存能续用，不代表数据实时

RepoBar 先读持久化 SQLite 缓存，再后台刷新；兼容归档可以在离线或限流时补充议题和 PR 列表。但缓存里有一条 PR，不代表它现在仍未合并。官方缓存文档承认，逐条显示陈旧数据来源标签仍有改进空间，不能假定每行都有清晰的缓存年龄。

REST 剩余请求数与 GraphQL 剩余点数单位不同，也只是最近观测值。额度显示未知或进入冷却时，不要通过反复刷新推断服务已经恢复。0.10.2 的官方记录日期是 2026-10-18，改进是把仓库详情写盘合并到 30 秒窗口；它不是新增分诊能力，也没有证明工作速度快了多少。

与已有工具怎么分工

• GitHub 通知收件箱适合围绕已订阅的事件做 Save、Done、Unsubscribe 和筛选。若问题只是通知太多，先整理收件箱可能就够了。RepoBar 的选择理由是把多仓库概况与本地检出状态放到菜单栏，而不是证明通知收件箱“不行”。
• 终端里的 Git适合检查实际工作树与差异。Git 官方的 status 文档定义了暂存、未暂存和未跟踪文件；RepoBar 汇总有助于选定项目，修改前仍应确认实际状态。
• 代码审查与 CI 页面仍负责深入调查。本文不宣称 RepoBar 能替代代码审查、解决冲突或提供绝对实时数据。

适合需要多仓库第一轮检查的维护者、轮值开发者。不太适合只偶尔处理一个仓库、使用 macOS 14 或更早系统，或者所在组织不允许第三方应用访问仓库的用户。

价格、权限与下载

官方当前标明免费、MIT 许可证，支持 macOS 15+ 的 Apple silicon 与 Intel Mac。0.x 版本仍在持续变化；本文不是稳定性保证。GitHub.com 访问受登录用户权限和 RepoBar GitHub App 安装范围共同限制；私有组织仓库可能需要组织批准。发行构建将凭据保存在 macOS Keychain，调试构建的存储方式不同。不要将凭据贴进截图或问题报告。

官网、README 和历史更新记录对可选引用监视器的权限描述存在差异，因此本文不提供其权限设置建议；核心仓库检查流程无需启用它。可选 AI 摘要、账户与 Enterprise 配置不在本次流程内，不因应用免费而推定外部服务免费。

在 OpenNavo 查看 RepoBar，或前往官方发行页下载。先确认系统、仓库授权和本地工作区，再决定是否开启同步。

来源与核验

核验日期：2026-10-19。功能与步骤来自 官方 README、Local Projects 文档、缓存设计；维护记录见 0.10.2 Release，费用与平台见官网，许可见 LICENSE。比较依据为 GitHub 通知文档、git status 与 git pull。