打开 VS Code,先得决定开哪个仓库。手头在做的项目心里有数,但改动留在哪、上一次提交推没推、开工前要不要先拉一把,这些不一定记得住。
现在切仓库的频率更高了。一个项目里的小任务,随时会打断另一个项目里的长活。如果编码智能体在单独的 Git 工作树里干活,那就又多了一个要记的检出目录。文件 → 最近打开能把人送回某个文件夹,可文件夹里到底等着什么,还是得打开才知道。
于是有人做了 Repo Board,一个 VS Code 扩展,把本地仓库的 Git 状态集中到一个标签页里,让人在打开仓库之前就把这道选择题做掉。作者提到,自己与 AI 协作的方式正是催生这个工具的原因之一;不过扩展本身只读取 Git,运行时不涉及 AI。
指向一个父文件夹,往下扫三层
设置只需要做一次:把扩展指向存放克隆仓库的文件夹。安装引导会要求填一个待扫描目录,比如 C:\code 或 ~/src,扩展会在其下寻找 Git 仓库,默认深度为三层。只想加单个仓库,就打开它,在命令面板运行 Repo Board: Add Current Folder。
第二个需求是把几个仓库固定在同一处。一个仓库可能整周都重要,哪怕今天只打开过一次。钉住之后,它会留在面板顶部的 Pinned 区域,项目切换器也会优先显示钉住的仓库。
想让它成为打开 VS Code 看到的第一个标签页,在安装引导或面板的 ⋯ 菜单里选择 Use Repo Board as Start Page。该设置作用于未打开文件夹的新窗口。想恢复原来的启动设置,运行 Repo Board: Stop Using Repo Board as Start Page 即可。
“要不要拉”不是一个数字能回答的
看演示里的 checkout-web:分支 feature/apple-pay,7 个文件改动,本地提交领先上游 1 个,落后 2 个。这三个数字说的是三件事——文件改动在工作区或索引里;领先数表示本地有一个上游没有的提交;落后数表示上游有提交还没合进来。面对这样一块面板,作者的做法是先打开仓库看差异和历史,再决定怎么更新。
面板能缩短这份决策清单。With changes 筛出有未提交改动的仓库,Most changes 把改动数量最多的排前面,切到 Behind 则能看到哪些分支需要更新。状态筛选帮着决定打开哪个文件夹,面板还能直接在那里开一个终端。
底层靠的是 git status --porcelain=v2 --branch,它提供分支、上游、领先与落后计数以及文件状态。领先和落后是相对于 Git 本地已知的上游而言。如果有人五分钟前刚推了代码,单靠一次状态检查是看不到的。面板打开时可以在后台抓取,刷新期间显示缓存信息,所以这些计数只当作快照看。不想自动抓取,关掉 repoBoard.fetchOnOpen 手动执行。
抓取只是更新 Git 对远端的认知;拉取可能移动当前检出的分支、改动文件,所以是一个需要主动选择的动作。Repo Board 的拉取使用 --ff-only:两边都有新提交时,Git 会停下来,把如何合并的决定留给人。对 checkout-web 这个例子来说,这正是想要的行为。
要横扫整个面板,Repo Board: Fetch All Repos 会刷新有上游的仓库;Repo Board: Pull All Repos That Are Behind 先抓取,再对落后的仓库尝试快进,工作区里已有冲突的仓库会被跳过。
改动到底留在哪个工作树里
一个干净的主检出,旁边可能就挂着一个还有未完成编辑的链接工作树。活是在链接工作树里干的,只打开主文件夹等于只答了一半。智能体为某个任务使用单独检出时很容易撞上这种情况,自己用 git worktree 也一样。
默认情况下,Repo Board 把链接工作树归到主仓库下面。点工作树徽标,可以看分支、打开正确的检出,或在那里开终端。演示里 agent/fix-checkout-total 显示 6 处改动,review/pr-412 被标记出来,因为它的文件夹已经不在了;两条记录都属于 storefront。想让每个工作树各自成为一个项目,把 repoBoard.worktrees 设为 separate。
已经知道要开什么的时候,面板可以留在后台。Windows 或 Linux 按 Ctrl+Alt+P,macOS 按 Cmd+Alt+P,输入仓库名、路径、分支或标签的一部分即可。快捷键被占用时,去命令面板找 Repo Board: Switch Project…。
安装方式是从 VS Code 市场装 Repo Board,或者在 PATH 里有 code 命令行时执行:
- code --install-extension emanuelebartolesi.vscode-repoboard
作者的建议是先从一个日常在用的文件夹开始,钉住两个经常回访的仓库,下次打开空的 VS Code 窗口时试试这个起始页,看能不能在打开项目之前就判断出上次停在哪里。扩展以 MIT 许可证开源,遇到文件夹结构、上游或工作树方面的问题,可以去 GitHub 提 issue。
热门跟贴