【已审核】feat(git-diff): 文件改动 tab 仓库选择器——按仓库聚合所有 worktree 变更与分支对比

[climashscape]

概述

右侧边栏「文件改动」tab 在包含大量 Git 仓库的项目根（monorepo / fork 集合）下存在两个痛点：所有仓库的改动混杂显示无法聚焦；主仓库的 git worktree 分支改动（.worktrees/ 下）默认扫描不到。

本 PR 引入仓库选择器：把工作区扫描到的 Git 仓库加入下拉并绑定会话，选中后该会话只扫描此仓库的所有 worktree（含 main 与各分支 worktree），以聚合视图展示未提交改动 + 领先/落后 commit 概览；支持仓库内单 worktree 细化、分支间对比（A vs B）、手动添加仓库、基准分支自动探测。同时以 merge 形式包含 perf/git-diff-parallel-cache（PR #1424）的扫描性能优化作为基础设施。

改动

• apps/electron/src/main/lib/git-diff-service.ts（+831）：新增 listRepos / getRepoChanges / listWorktreesFromRoot / resolveDefaultBaseBranch（单次 for-each-ref + 30s 缓存）；findAllGitRootsDown 区分 .git 目录与 worktree 指针文件；默认 getUnstagedChanges 枚举 worktree；多级缓存 + 定向失效
• apps/electron/src/main/ipc.ts：新增 git:list-repos / git:get-repo-changes / shell:select-directory，逐 worktree 路径授权、缓存 key 会话隔离
• apps/electron/src/preload/index.ts：electronAPI 新增 listRepos / getRepoChanges / selectDirectory
• packages/shared/src/types/runtime.ts：新增 RepoInfo / RepoChangesResult / RepoWorktreeChanges / CommitSummary 类型与 3 个 IPC 通道
• apps/electron/src/renderer/components/diff/RepoSelector.tsx（新增）：仓库下拉选择器，绑定会话，支持手动添加仓库
• apps/electron/src/renderer/components/diff/WorktreeSelector.tsx：改造为仓库内工作树过滤条，支持对比基准选择（A vs B 双向 commit 概览）
• apps/electron/src/renderer/components/diff/DiffChangesList.tsx：聚合视图（worktree 分组 + 领先/落后 commit + 折叠/搜索）+ 单 worktree 细化视图切换；兼容上游 feat(agent): surface non-git file changes #1429 的 non-git 文件变更展示
• apps/electron/src/renderer/atoms/agent-atoms.ts / SidePanel.tsx / LeftSidebar.tsx / useGlobalAgentListeners.ts / workspace-watcher.ts：per-session 选择状态、缓存清理、预览基准透传、写文件失效
• apps/electron/src/main/lib/git-diff-service.test.ts（新增）：临时仓库集成测试（发现/枚举/聚合/基准探测）

与 PR #1424 的关系（重要）

• 本 PR 包含 perf/git-diff-parallel-cache（PR 【已审核】perf(git-diff): 大量 git 仓库项目根扫描卡顿优化——并发预检 + 三层缓存 + 定向失效 #1424）的扫描性能优化（并发预检 + scanCache/perRepoCache/gitRootsCache 三层缓存 + 定向失效 + watcher 过滤），作为仓库选择器功能的基础设施（findAllGitRoots 缓存、invalidateGitDiffCache 定向失效被 listRepos/getRepoChanges 依赖）。
• 建议合并顺序：先合并 【已审核】perf(git-diff): 大量 git 仓库项目根扫描卡顿优化——并发预检 + 三层缓存 + 定向失效 #1424，再合并本 PR。如此本 PR rebase 后 perf 相关代码自动消去，仅剩仓库选择器功能；反向顺序则 【已审核】perf(git-diff): 大量 git 仓库项目根扫描卡顿优化——并发预检 + 三层缓存 + 定向失效 #1424 需要 rebase 去重。
• 若维护者希望本 PR 独立、不含 perf 代码，请告知，可另行拆分（需重做缓存依赖，工作量较大）。

测试

• bun run --filter=@proma/electron typecheck ✅
• build:main / build:preload / build:renderer ✅
• bun test 5 个集成用例全过（临时 git 仓库验证 findAllGitRoots / listRepos / worktree 枚举 / getRepoChanges 聚合 / 基准自动探测）
• dev 实测：选中 Proma 仓库显示 5 个 worktree 聚合（分支/head/commits/文件统计）、单 worktree 细化、对比基准切换显示「基准独有 commits」、添加仓库对话框均正常

紧急度

常规

备注

• Closes 希望增加git组件和代码diff差异查看组件 #290（open 功能请求：增加 git 组件与代码 diff 差异查看组件——本 PR 提供仓库选择器 + worktree 聚合 + 分支对比，实质满足该诉求）
• Related: feat: add worktree support to Changes tab #649 feat: multi-repo worktree config support #650（既有 Changes tab worktree 支持基础，本 PR 在其上增强为按仓库聚合）
• 基准分支自动探测：origin/main → origin/master → 本地 main → HEAD~1；显式对比基准时用两点 diff 展示两分支全部差异
• worktree 枚举走 10s 短 TTL 缓存，listRepos 60s TTL + 强制刷新
• rebase 至最新 main（d7f76914），已兼容上游 feat(agent): surface non-git file changes #1429（non-git file changes）的 DiffChangesList 改动

[climashscape]

作者主动关闭（本地 build/long-term 维护流保留这些功能，不再向上游提交）。