chore(release): 同步 v0.0.16 至 master —— 多根工作区仓库切换 · 分支分组树 · Agentic Git 预置 · Diff 与布局修复

[ThreeFish-AI]

概述

将 feature/1.x.x 同步至 master，引入 v0.0.16 正式版——自 v0.0.14 以来的全量积累（0.0.15 版本号已就位但未单独发布，本版一并发布）。本 PR 为正式版回流主分支的同步 PR，不含新增开发内容。

• 规模：25 个提交 · 54 个文件 · +2938 / −510
• 内容：4 项新特性（多根工作区仓库切换 / Branches 前缀分组树 / Agentic Git 偏好配置 / Claude Code 配置预置）+ 1 项 Diff 缺陷修复 + 1 项面板默认布局调整 + pnpm 12 与开发依赖批量升级
• 产物：GitHub Release v0.0.16 已发布，hyper-git-agentic-git-0.0.16.vsix 已上架；Marketplace 发布失败，详见下方「已知问题」
• 用户视角完整叙述：Release Note v0.0.16 · CHANGELOG

变更内容

✨ Added — 多根工作区仓库切换（#108 / issue #107）

多根工作区含多个 Git 仓库时，此前 Hyper Git 只能操作单一仓库。本版将 Graph 工具栏仓库名升级为可切换按钮（对标 Git Graph；单仓库退化为纯文本，多数用户零感知），并提供 Hyper Git: Select Repository… 命令直达。

• 七视图级联：切换后 Graph / Branches / Commit（changelist）/ Stash / Shelf / Worktrees / 未提交角标全部跟随新活跃仓库刷新；
• 按仓库隔离记忆：changelist 分配、分支收藏、分组偏好、Shelf 存储（shelves/<basename>.<sha1[:8]>/ 随活跃仓库动态求值）、最近提交消息（per-repo key + 旧全局 key 一次性回落）、Graph/Commit webview 视图状态（v2 byRepo 分区）；
• 数据迁移安全：Shelf 旧平铺数据一次性迁移仅 rename、零删除零覆盖；
• 选取逻辑下沉纯函数 engine/git-state/repo-selection.ts（持久化恢复 → folder0 匹配 → 首个仓库，三级优先），三重顺序不变量保证 rebind 先于视图刷新；活跃仓库持久化于 workspaceState（hyperGit.activeRepoRoot），重开窗口回到上次操作的仓库；
• 顺带修复激活竞态（repo 发现晚于 activate 时 memento key 落占位根）与 Blame 注解切库残留；
• 测试：新增 multi-root 双仓库 fixture 集成套件 tests/suite/multi-root.test.js（activate() 导出 { service } 程序化接缝）。

📄 多根工作区仓库切换

✨ Added — Branches 按 / 前缀分组为文件夹树（#86）

Local / Remote / Tags 三段支持在平铺 ⇄ 树间切换：共享前缀的分支收拢到以前缀命名的可折叠文件夹下、叶子仅显示末段后缀（feature/1.x.x、feature/2.x.x → 📁feature），远程整体收拢为 origin 文件夹。

• 新增纯逻辑引擎 buildRefTree——复用「变更文件目录树」buildFileTree 的 trie 构建 + compact 折叠范式；叶子携完整 RawRef，命令定位不受影响；
• 分支感知排序：当前 HEAD → 收藏 → 同档文件夹优先、名称数字感知升序；
• 隐藏 origin/HEAD 符号引用（对齐主流 Git UI，消除 origin 叶子与 origin 文件夹同名冲突）；
• 零破坏：文件夹节点用独立 contextValue 且不登记任何右键命令，checkout / delete / rename / merge / rebase / compare / favorite 与多选批量全部零改动；偏好按仓库持久化（默认树形）。

📄 分支前缀分组树

✨ Added — Agentic Git 偏好配置（#89，M5 前置铺垫）

新增 hyperGit.agent.* 四项原生设置为 M5 AI 接缝 铺路：

配置项	作用
hyperGit.agent.baseBranch	创建 PR 的基线分支（留空 = 仓库默认分支）
hyperGit.agent.commitPreferences	点击 Commit 时发送给 agent 的自定义指令
hyperGit.agent.createPrPreferences	点击 Create PR 时发送给 agent 的自定义指令
hyperGit.agent.reviewPreferences	点击 Review 时发送给 agent 的自定义指令

三项指令均以 editPresentation: "multilineText" 多行文本域承载并内置默认模板（Commit 模板由中文提交规约译为专业英文，Create PR / Review 模板逐字内置，含 ${TARGET_BRANCH} / #{pr_number} 等占位符）。采用原生设置承载——零新增 Webview / 命令 / TS / 测试，默认值内联于 package.json。仅落地配置与默认模板，agent/ 五接缝与 hyperGit.ai.enabled 行为不变、零破坏。

📄 Agentic Git 偏好配置

✨ Added — Claude Code 配置（#88，M5 前置铺垫）

• 设置项 hyperGit.claudeCode.executablePath：Claude Code CLI 可执行路径，留空 = 从 PATH 自动探测 claude；描述内嵌 command: 链接就地提供「浏览 / 打开 Claude 设置」；
• 命令 hyperGit.setClaudeCodePath（QuickPick：Browse 文件选择器写回 / Use system Claude Code 清空覆盖）与 hyperGit.openClaudeSettings（打开 ~/.claude/settings.json，缺失时经确认创建 {}）；
• 路径解析下沉纯函数 engine/agent/claude-path.ts（Vitest 可测），命令实现见 adapter/claude-commands.ts；零新增 Webview 面板。

📄 Claude Code 配置

🐛 Fixed — 新增 / 删除 / 重命名文件的差异视图可正常打开（#87 / issue #15）

新版 VS Code 的 readFile 对不存在的具名 ref 抛 FileNotFound，导致新增文件（无旧端）、删除文件（无新端）在 Commit / Graph 视图打不开差异。

• 缺失端改用 git 空树 ref 构造 URI，跨 VS Code 版本稳定解析为空内容；
• 按状态正交分解（engine/diff/change-side.ts）：新增→空树置旧端、删除→空树置新端、重命名→两端异路径；
• 补齐 Graph 视图逐文件 status / oldPath 传参与干净路径，修复重命名点击崩溃；
• 新增分类器与端点解析的单元 + 集成测试（tests/suite/diff-open.test.js），根因沉淀至 issue #15。

♻️ Changed — 面板视图默认布局调整（#101 / issue #16）

package.json contributes.views 声明式微调六视图默认态，src/ 零改动：

• Stash / Shelf：collapsed → visibility: "hidden"（默认不出现在容器内，仍可经视图标题右键菜单勾选恢复）；
• Commit / Worktrees：visible → collapsed（显示但默认折叠）；
• Branches / Graph：保持 visible；
• 顺序：Commit · Branches · Graph · Worktrees（Stash · Shelf 隐藏排其后），initialSize 权重不变；
• 新增 tests/unit/views-layout.test.ts 声明式护栏锁定顺序与各视图 visibility。

平台约束：visibility 仅影响全新安装 / 干净 profile 的初始态——老用户升级后需执行「View: Reset View Locations」或右键容器页签「Reset Location」方采用新默认（同 issue #12 / #13 平台行为）。

♻️ Changed — @vscode/test-electron 3.0.0 → 3.1.0

VS Code 1.110 起将 macOS 主二进制 Electron 更名为 Code（兼容符号链接于 2026-07 移除，microsoft/vscode#326502），3.0.0 启动 1.110+ 即 spawn .../MacOS/Electron ENOENT 崩溃；3.1.0 按 Info.plist → CFBundleExecutable 三级解析修复（microsoft/vscode-test#348）。此前 dependabot #102 因 supply-chain 发布冷静期被 CI 拦截，本次窗口已过正式合入。

📦 Build

• pnpm 11.9.0 → 12.2.1（chore(Release): 升级 pnpm 12.2.1 并发布 v0.0.16 —— 多根工作区仓库切换 · 分支分组树 · Agentic Git 预置; #113）：pnpm 12 为 Rust 重写版，命令 / flags / 配置 / 锁文件格式全部延续 pnpm 11（allowBuilds 与 node-linker=hoisted 沿用），CI 经 pnpm/action-setup@v6 从 packageManager 字段自动跟随，依赖解析零变化；
• CI dlx → exec：pnpm 12 的 dlx 对 @vscode/vsce 未审批的原生构建脚本硬失败，改用 pnpm exec vsce 走锁定的项目内版本（README 同步更正）；
• 开发依赖批量升级（dependabot）：prettier 3.9.5→3.9.6（chore(deps-dev): bump prettier from 3.9.5 to 3.9.6 #104）、@types/node 26.1.1→26.4.0（chore(deps-dev): bump @types/node from 26.1.1 to 26.4.0 #112）、eslint 10.7.0→10.9.1（chore(deps-dev): bump eslint from 10.7.0 to 10.9.1 #111）、vite 8.1.5→8.2.2（chore(deps-dev): bump vite from 8.1.5 to 8.2.2 #110）、vitest 4.1.9→4.1.10（chore(deps-dev): bump vitest from 4.1.9 to 4.1.10 #94）、typescript-eslint 8.64.0→8.68.0（chore(deps-dev): bump typescript-eslint from 8.64.0 to 8.68.0 #109）、actions/setup-node v6→v7（chore(deps): bump actions/setup-node from 6 to 7 #96）；
• dependabot 忽略 typescript major 升级（ci(dependabot): 忽略 typescript major 版本升级（TS7 工具链未适配） #100）：TS7 工具链未适配，待 7.1 后人工重启。

📝 Docs

• 新增 4 篇特性文档（多根仓库切换 / 分支分组树 / Agentic Git 偏好 / Claude Code 配置）+ Release Note v0.0.16（GitHub Release 正文单一事实源）；
• 同步 CHANGELOG、docs/releases/README.md 索引、docs/README.md、知识索引、里程碑状态与 AI 接缝调研的「最新发布」指针；
• README 中英文指标行校正：6 视图 · 97 命令 · 6 配置项 · 324 单元测试 → 6 视图 · 102 命令 · 11 配置项 · 403 单元测试（此前指标已滞后 HEAD）。

变更规模

层次	内容
engine/（纯逻辑，零 vscode 依赖）	新增 git-state/repo-selection.ts · ref/ref-tree.ts · diff/change-side.ts · agent/claude-path.ts · git-state/shelf-dir.ts
adapter/（VS Code 适配）	新增 repository-selection.ts · claude-commands.ts · diff-sides.ts；改造 tree/branches-tree.ts · webview/log-webview.ts · webview/commit-webview.ts · git-repository-service.ts · shelf.ts · changelist-registry.ts · branch-favorites.ts 等
测试	新增 8 个 Vitest 单测文件 + 2 个集成套件（multi-root / diff-open），单测总量 324 → 403
文档	4 篇特性文档 + Release Note + CHANGELOG + README 中英同步
工程	pnpm 12 · 7 项依赖升级 · CI 打包命令修正 · dependabot 策略

验证

• ✅ PR CI 全绿：Lint & Build · Test（ubuntu-latest / macos-latest / windows-latest）· Package vsix
• ✅ 单元测试 403 例通过（Vitest，engine 纯逻辑）
• ✅ 集成测试（@vscode/test-electron）：新增 multi-root 双仓库套件与 diff-open 套件
• ✅ 合并状态：MERGEABLE，与 master 无冲突
• ✅ 发布流水线：GitHub Release + .vsix 资产已上架（见下方已知问题中的例外项）

⚠️ 已知问题

VS Code Marketplace 发布失败（不阻塞本 PR 合并）：tag v0.0.16 推送触发的流水线中 Publish job 失败，vsce publish 返回 Access Denied: The Personal Access Token used has expired。同一 run 内 GitHub Release 与 .vsix 资产上传均成功。

• 影响：Marketplace 侧仍停留在旧版本，用户暂需经 Release 页面 下载 .vsix 手动安装；
• 处置：轮换仓库 Secret VSCE_PAT 后重跑该 workflow 即可，无需改动代码。

关联

• 上游链路：feat(Branches): 分支视图支持按 / 前缀分组为可折叠文件夹树(平铺⇄树切换); #86（分支分组树）· fix(Diff): 新增/删除/重命名文件在 Commit 与 Graph 视图可正常打开差异; #87（Diff 修复）· feat(ClaudeCode): 新增可执行路径设置与 Claude 设置文件快捷入口(Agentic Git 预置); #88 / feat(AgentConfig): 新增 hyperGit.agent.* 四项 Agentic Git 偏好配置(M5 铺垫); #89（Agentic Git 预置）· feat(views): 调整面板视图默认布局（显隐与顺序） #101（布局调整）· feat(multi-repo): 多根工作区仓库切换（Graph 选择器 + 全局活跃仓库级联，issue #107） #108（多根仓库切换）· chore(Release): 升级 pnpm 12.2.1 并发布 v0.0.16 —— 多根工作区仓库切换 · 分支分组树 · Agentic Git 预置; #113（pnpm 12）+ 依赖升级若干 → 本 PR（回流 master）
• 问题沉淀：issue.md（feat(Inline-Commit): editor 行内提交 CodeLens（#13） #12 / feat(Parity-Batch4): 忠实 Shelf + 交互式 Rebase UI + Move Hunk to Changelist #13 布局平台行为 · feat(Parity): 复刻 IDEA Git 工具窗口全量功能（Branches/Log/Graph/Merge/Rebase）; #15 Diff 缺失端 · ci+chore(Release): v0.0.1-rc.3 发布 + GitHub Release 自动附带可本地安装的 .vsix #16 默认布局决策）
• 用户视角叙述：Release Note v0.0.16
• 工程视角记录：CHANGELOG