Hyper Git - Agentic Git v0.0.23 — 本地分支 PR 状态徽标 · 开发依赖升级

本版核心：Branches 视图的 PR 状态徽标从远程分支扩展到本地分支——Local Branches（含 Favorites 本地条目与活动分支）行右侧以与远程行一致的形态显示关联 GitHub PR（#N Merged/Open/Closed/Draft），一眼看清哪条本地分支的 PR 已合并、可安全删除；非活动分支图标按 PR 状态着色，悬停同样可见 PR 号 / 标题 / Open on GitHub。

✨ 亮点速览

• 本地分支行 PR 徽标：Local Branches 每行右侧显示关联 PR（#138 Merged 形态与远程行一致），Favorites 中的本地条目与当前活动分支同样生效（活动分支呈 active #138 Merged，状态由徽标文本承载）；
• 图标按状态着色：非活动本地分支的分支图标按 PR 状态着色——Merged 紫 / Closed 红 / Open 绿 / Draft 弱化；活动分支蓝、收藏黄优先于 PR 状态色，与既有视觉语义零冲突；
• 宁缺勿错的匹配语义：本地裸分支名走「同仓 Tier b → 唯一兜底 Tier c」——多 fork 同名分支产生歧义时不显示，绝不展示错误 PR；不剥 remote 前缀、不做 fork 身份匹配（本地名不携带 remote 身份），本地名 origin/feature 只匹配字面同名的 PR；
• 零新增请求、零取数改动：完全复用远程行既有的 GraphQL 取数链路（最近更新的全态 PR 列表、TTL 缓存、限流退避），本地行匹配为预计算索引上的 O(1) 查询，配置开关（hyperGit.branches.pr.enabled）与静默边界（未登录 / 非 GitHub 仓 / 配置关闭 → 零徽标零请求）不变。

🧩 特性详述

1. Branches 视图本地分支 PR 状态徽标（#158）

• 覆盖范围：Local Branches 分组全部本地分支、Favorites 中的本地条目、当前活动分支（HEAD）；远程分支行行为与 v0.0.22 完全一致，零回归；
• 匹配语义：远程短名沿用三级匹配（fork 全名身份校验 → 同仓 → 唯一兜底）；本地裸分支名只走后两级——按完整裸名先匹配同仓 PR（headRefName 精确相等），无命中且全库同名候选唯一时兜底显示该 PR（gh pr checkout / fork 工作流场景）；歧义（多 fork 同名）与掉出最近 100 条 PR 的旧分支静默无徽标。不用 ref.upstream 参与匹配，消除 API / CLI 双数据路径下的徽标闪烁；
• 预期分歧：本地名形如 owner/branch（fork checkout 形态）不参与 fork 身份匹配——本地行无徽标而对应远程行可经身份校验有徽标，属有意设计（本地名不携带 remote 身份，无法安全校验）；
• 实现锚点：engine 层 RemotePrIndex 更名 BranchPrIndex 并新增 lookupLocal 入口（同一份预计算索引、双查询入口），增量与全量单测覆盖；详见功能文档。

⚙️ 升级与兼容

• 无破坏性变更：全部既有命令、视图与配置项保留；远程分支行的徽标形态、着色与 Tooltip 行为不变；
• 开发依赖升级（#157）：@types/node 26.6.6、@vscode/vsce 4.1、eslint 10.14、rimraf 6.1、typescript-eslint 8.72.1、vite 8.3.5、vitest 5.1（全部 devDependencies，对扩展运行时零影响）。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装或更新。
• Open VSX：搜索 Hyper Git - Agentic Git 直接安装或更新（覆盖 Cursor / Windsurf / VSCodium 等 Open VSX 系编辑器）。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.23.vsix → 命令面板 Extensions: Install from VSIX。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG。

许可证：MIT。

Hyper Git - Agentic Git v0.0.22 — Graph 过滤持久化与激活指示 · Branches 就地更新 · 开发依赖升级

本版核心：Graph 视图全部 7 个过滤维度按仓库持久化（Author / File Path / Grep / Merge Mode / Date / Message Regex）——重启 VS Code 或切换仓库再切回，过滤条件自动恢复为上次设置，每个仓库记忆自己的完整过滤组合；过滤生效期间标题栏过滤图标点亮为填充态（Graph Filter Active），恢复的过滤不再是无声约束。同时 Branches 视图迎来分支就地更新（不 checkout）：右键 Update Branch 以 git fetch 原生 fast-forward-only 原语安全前移本地分支，永不改写本地提交。

✨ 亮点速览

• 过滤持久化：任一过滤维度设置后即按仓库落盘（workspaceState），重启 / 切库往返自动恢复；空选确认与 Clear Filter 的「清除」同样持久化，重启不复活；脏持久化数据逐字段校验免疫，永不崩溃。
• 过滤激活指示：过滤生效期间标题栏过滤图标切换为填充态 $(filter-filled)（悬停标注 Graph Filter Active），与常态图标按激活态互斥呈现——重启恢复的过滤一眼可见。
• 重开 Author 过滤即续选：重开「Filter by Author…」预勾选已选作者（含不在当前候选集的持久化作者，以 ghost 项呈现）继续增删；pattern 项经「Use pattern」逃生口完整保留。
• 分支就地更新：右键单个分支 Update Branch、多选批量更新、标题栏 Pull 升级为选区感知——fast-forward-only 安全拒绝 diverged / ahead-only 分支（附真实原因），永不改写本地提交；五桶对账汇总（updated / up-to-date / pulled / skipped / failed）。
• 切库守卫全覆盖：任何过滤对话框（含 Filter Graph 聚合入口）或 Commit 文件右键菜单打开期间发生切库后确认，不再把旧仓库语境的选择误写新仓库。
• 越仓选择拒绝：Filter by Path 选中当前仓库外的文件时以告警拒绝，不再落入 ../… 垃圾 path 过滤（该垃圾 path 会随持久化成为跨重启的图加载 fatal 错误态）。

🧩 特性详述

1. Graph 过滤按仓库持久化与激活指示（#152）

• 存储范式：沿用 scope / detail mode 的按仓库 workspaceState 范式——authors 独立 key（hyperGit.log.authors:<repoRoot>），其余 6 维组合 key（hyperGit.log.filter:<repoRoot>，单 key 原子读写防半恢复态，Date 经 ISO 串往返）；脏数据经 engine 层纯函数逐字段校验（空串、mergeMode all 等归一化不落盘）；
• 激活指示：engine 纯函数 hasActiveFilter（激活判定与持久化归一化同口径）驱动 hyperGit.log.filterActive context key，标题栏过滤图标常态（$(filter)）/ 填充（$(filter-filled)）双命令互斥呈现，alt+g 键绑定不受影响；
• 附带行为变更：① SCM 变更列表右键「Show History」由整替过滤器改为与其余过滤命令一致的增量式——文件历史与活跃过滤相交而非静默清空；② issue #107 的「切库清空 host 级过滤」限制消除——每个仓库记忆自己的完整过滤条件。

2. Branches 视图分支就地更新（#151）

• 底层原语：git fetch <remote> refs/heads/<upstream>:refs/heads/<branch>——git 原生 fast-forward-only，diverged / ahead-only 分支被安全拒绝（附真实 stderr 原因）；当前分支自动改走 repo.pull()（含冲突处理通道）；无上游分支透明跳过；
• 选区感知 Pull：Branches 标题栏 Pull 按钮在有多选分支时按选区执行就地更新（无选区保持原 Pull 语义，Commit 视图 Pull 不受影响）；
• 五桶对账：updated / already up to date / pulled / skipped / failed 汇总（选中数 = 各桶之和），up-to-date 经前后 objectname 短 sha 前缀比对判定；upstream 解析以一次 for-each-ref 取新鲜快照（不信任树节点数据），origin/x 拆分复用最长前缀匹配（remote 名可含 /）。

⚙️ 升级与兼容

• 无破坏性变更：全部既有命令、视图与配置项保留；过滤组合语义（各维度 AND、多作者 OR）与 v0.0.21 一致；
• 行为改进：过滤条件由「仅内存、切库清空」升级为「按仓库持久化」——升级后首次使用即开始记忆，无迁移步骤；此前会话内的所有过滤行为（空选清除、pattern 逃生口、Clear Filter）语义不变，仅新增跨重启存活；
• 开发依赖升级（#153）：eslint 10.13 / typescript-eslint 8.72 / vitest 5.0.5 / ovsx 1.3（全部 devDependencies，对运行时零影响）。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装或更新。
• Open VSX：搜索 Hyper Git - Agentic Git 直接安装或更新（覆盖 Cursor / Windsurf / VSCodium 等 Open VSX 系编辑器）。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.22.vsix → 命令面板 Extensions: Install from VSIX。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG。

许可证：MIT。

Hyper Git - Agentic Git v0.0.21 — Filter by Author 候选建议 · 多选过滤 · 元字符作者修复

本版核心：Graph 视图「Filter by Author…」从「裸输入框完整手输单个作者名」升级为「候选建议 + 多选」。候选列表来自仓库真实提交作者（git shortlog 按当前视图范围取数、按提交数降序）——输入 Thr 即在下拉中建议 ThreeFish，姓名与邮箱均可模糊匹配，点选即填、无需手输完整 ID；依次勾选多个提交者即可按作者集合过滤 Graph 视图（OR 语义）。同时修复了作者名含正则元字符（如 dependabot[bot]）时过滤 0 命中的隐性缺陷。

✨ 亮点速览

• 前缀输入提示：在过滤输入框键入姓名或邮箱前缀，下拉即时给出匹配的提交者（附提交数与邮箱），点选即选中——不再要求人工完整输入作者名。
• 多选过滤：依次勾选任意多个提交者，Graph 视图立即按所选作者集合过滤（任一命中即保留）；空选确认 = 清除作者过滤，Esc = 取消不改。
• 正则逃生口：输入不等于任何作者姓名时，下拉头部动态提供「Use pattern "xxx"」项——手输任意正则原样透传，旧输入框的任意 pattern 能力完整保留，且可与选中身份混用（OR）。
• 元字符作者修复：dependabot[bot] 这类含 [ ] . + 的作者名此前按正则原样传递导致 0 命中；现在从候选选中的身份按字面精确匹配（BRE 转义 + 全行锚定 Name <email>，同名异邮箱不混淆）。

🧩 特性详述

1. 作者候选建议与多选（#149）

• 候选取数：git shortlog -sne 按当前 Graph 视图 scope（All / Current / Checkpointer）取真实提交作者，按提交数降序、附邮箱——候选与视图所见范围一致，切换 scope 后重开即同步；
• 多选语义：多个作者翻译为多条 git log --author（git 原生取 OR）；与 Message / Path / Date / Merge 等其它过滤维度仍为 AND 组合，Clear Graph Filter 一键全清；
• 交互细节：等待取数期间显示 busy 且可先输入；已勾选项在继续键入过滤时保持不丢；再次打开时预勾选当前已过滤的作者，便于增删；空仓库 / 查询失败时降级为仅 pattern 输入（近似旧行为）。

2. BRE 字面转义修复（#149）

• git log --author 的 pattern 缺省按 POSIX BRE（Basic Regular Expression）解释：dependabot[bot] 中的 [bot] 是字符类、. 匹配任意字符——作者名原样传递即偏离字面语义，含 [ ] 的作者 0 命中、含 . 的作者可能误伤他人；
• 修复：从候选选中的作者身份按 BRE 语义转义（仅 \ . [ * ^ $ 有特殊义；+ ? | ( ) { 在 BRE 中本就是普通字符，勿加反斜杠）并首尾锚定 ^Name <email>$ 全行匹配——精确身份、同名异邮箱不混淆（本仓库实测：dependabot[bot] 修复前 0 命中、修复后 36 命中）。

⚙️ 升级与兼容

• 无破坏性变更：全部既有命令、视图与配置项保留；其它过滤维度（Message / Path / Date / Merge / Regex）行为与组合语义与 v0.0.20 一致；
• 行为改进：作者过滤条件仅存于内存（切换仓库自动清空，不持久化），升级后无遗留状态迁移问题；手输任意正则的能力经「Use pattern」项完整保留。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装或更新。
• Open VSX：搜索 Hyper Git - Agentic Git 直接安装或更新（覆盖 Cursor / Windsurf / VSCodium 等 Open VSX 系编辑器）。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.21.vsix → 命令面板 Extensions: Install from VSIX。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG。

许可证：MIT。

Hyper Git - Agentic Git v0.0.20 — Delete Remote Branch 陈旧远程分支修复 · 删除失败可诊断

本版核心：修复 Branches 视图「Delete Remote Branch」对「服务端已不存在」的远程分支误报失败、且删除失败时不显示任何原因的问题。PR 合并后被 GitHub 自动删除的分支，在下次 fetch --prune 前会以陈旧 remote-tracking ref 的形式留在 Branches 视图中；对它执行删除曾被服务端拒绝并回显笼统的「N failed」。本版把这类分支识别为「目标态已达成」——按成功收尾、就地清理本地陈旧 ref；真正的失败（保护分支拒绝 / 认证 / 网络）则在通知中逐分支附上 git 的真实报错，并可直达 Show Output 查看完整输出。

✨ 亮点速览

• 陈旧远程分支不再误报失败：删除「服务端已无此 ref」的分支（典型：PR 合并后远端自动删除）时，通知如实标注 N already gone on remote (pruned local tracking ref) 并同步清理本地陈旧 tracking ref，视图中的「幽灵分支」就地消失。
• 删除失败可诊断：真失败不再只回显笼统的「N failed」——保护分支拒绝、认证失败、网络错误等真实原因（stderr 优先）逐分支附在通知中，超长折叠单行、超 4 条截断标注；配合 Show Output 按钮直达 Hyper Git Console 查看完整输出。
• 错误文本提取单一事实源（gitErrorText）：新增 engine 纯函数统一「非空白 stderr 优先 → message → 兜底」提取语义；Push 对话框 / Update Project / Merge 对话框的失败通知随之升级为 stderr 优先，真实原因直达。
• 受保护主干与既有防护不变：main / master 硬阻断、当前分支上游软警示、删除前 modal 确认等既有行为全部保留。

🧩 特性详述

1. Delete Remote Branch 三桶语义（#147）

删除循环按结果三桶处理，通知如实计数：

• 成功：Deleted remote branch origin/foo（单条）/ Deleted N remote branches（多条）；
• 服务端已无此 ref（already gone）：git push <remote> --delete 被服务端以 remote ref does not exist 拒绝时，经 engine 分类器 isRemoteRefMissingError（匹配 git 2.x 规范文案及旧服务端变体，大小写不敏感）识别——该分支的目标态（服务端无此分支）已天然达成，按成功收尾并清理本地陈旧 tracking ref；通知单列 N already gone on remote (pruned local tracking refs)，不以误导性的「Deleted 0 …」开头；
• 真失败：保护分支拒绝（如删除远端当前分支）、认证 / 网络错误等——失败原因经 gitErrorText 提取（stderr 优先），通知逐分支附 branch (原因)；失败级通知联动 Show Output 查看完整 stderr。

2. 错误文本提取单一事实源 gitErrorText（#147）

• 新增 engine/git-state/git-error.ts（零 vscode 依赖，全量单测）：统一 CLI 通道（execGit 透传的 .stderr）与 vscode.git API 通道（GitError）的提取语义——非空白 stderr 优先（trim 后返回），回退 message，最终 String(e) 兜底；
• remote-commands / history-commands 的两处内联实现改为引用该单一事实源；Push 对话框 / Update Project / Merge 对话框失败通知由通用 message 升级为 stderr 优先（如「无上游」「non-fast-forward」等失败原因直接可读）；
• 存量 adapter 中约 13 处旧式内联 errMsg（只读 message）为预先存在的迁移债，将在后续版本逐步迁移，不影响本版行为。

⚙️ 升级与兼容

• 无破坏性变更：全部既有命令、视图与配置项保留；删除确认弹窗、受保护主干（main / master）硬阻断、当前分支上游软警示行为与 v0.0.19 一致；
• 行为改进：仅删除分支场景的通知文案与失败路径变化（更诚实、更可诊断）；already gone 分支的本地 tracking ref 现会被主动清理（此前仅成功删除项清理）。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装或更新。
• Open VSX：搜索 Hyper Git - Agentic Git 直接安装或更新（覆盖 Cursor / Windsurf / VSCodium 等 Open VSX 系编辑器）。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.20.vsix → 命令面板 Extensions: Install from VSIX。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG。

许可证：MIT。

Hyper Git - Agentic Git v0.0.19 — Branches 视图 PR 状态徽标 · 取数安全加固 · 开发依赖升级

本版核心：Branches 视图远程分支行右侧显示关联 GitHub Pull Request 状态徽标（如 #138 Merged，云图标按状态着色，悬停见 PR 号、标题与 Open on GitHub 链接）——分支 → PR 三级身份匹配（fork 全名 → 同仓 headRefName → 唯一兜底，歧义宁缺勿错），复用 CI 状态的 GitHub 认证，TTL 60s 缓存零刷新循环。同时加固取数安全：CI 与 PR 徽标注入「取数主机策略」（仅 github.com 与已配置 github-enterprise.uri 实例发数，杜绝 token 外发任意主机）、Tooltip 注入面多层封堵与外链白名单统一；并升级开发依赖基线（vsce 4 / vitest 5 / Node 22）。

✨ 亮点速览

• Branches 视图 PR 状态徽标：远程分支行右侧显示 #N Open / Merged / Closed / Draft，云图标按状态着色（Merged 紫 / Closed 红 / Open 绿 / Draft 弱化）；悬停见 PR 号、标题与经主机白名单校验的 Open on GitHub 链接。
• 三级身份匹配，宁缺勿错：fork 全名（remote 以 fork owner 命名且 URL 身份一致，host/owner/repo 三维校验）→ 同仓 headRefName（dependabot / 仓内分支主场景）→ 唯一兜底（多候选歧义时不显示）——绝不显示错误 PR。
• 零打扰取数：复用 VS Code 内置 GitHub 认证（与 CI 状态共享会话）；未登录 / 非 GitHub 远程 / 配置关闭 → 零徽标零请求；TTL 60s 缓存 + 首轮无徽标先行渲染，绝不阻塞建树、绝无刷新循环；限流 / 失败自动退避。
• 取数主机策略（安全）：CI 状态与 PR 徽标仅向 github.com 与已配置 github-enterprise.uri 的实例发送请求——origin 指向任意第三方「GitHub 形态」主机时视同非 GitHub（零请求），杜绝把 GitHub/GHE token 发往任意主机的凭证外发面。
• Tooltip 与外链安全（安全）：PR 标题等远程可控文本经单行化 + Markdown 语法转义 + 变长 code fence 多层消毒；command: 链接一律失效（isTrusted 白名单形态）；外链主机统一白名单（github.com / *.github.com / 仓库主机 / api.仓库主机），并以与浏览器同规范的解析封死 evil.com\@github.com 类分歧绕过。
• 依赖基线升级：@vscode/vsce 4.0.0、vitest 5.0.1（Node 基线 22）、ovsx 1.2.0、typescript-eslint 8.70.0、esbuild 0.28.2；dependabot 聚合升级（minor/patch 合单 PR），根除连环 lockfile 冲突。

🧩 特性详述

1. Branches 视图 PR 状态徽标（#142）

远程分支行右侧（ahead/behind 之后）显示关联 PR 的 #N 状态 徽标，云图标按 PR 状态着色：

• 数据源：GitHub GraphQL 按 UPDATED_AT 倒序取最近 100 条全态 PR（Open / Merged / Closed / Draft），与 CI 状态共用同一 GitHub 会话与 remote/provider 判定（单一事实源）；
• 三级匹配：fork 全名（Tier a，remote 以 fork owner 命名且其 URL 解析的 host/owner/repo 与 PR head 一致——排除 login 撞名、同 owner 他仓、异实例的误配）→ 同仓分支名（Tier b，dependabot / 仓内功能分支主场景，owner 大小写不敏感）→ 唯一兜底（Tier c，多 fork 同名歧义时不显示）；同一分支名多条 PR 取最近更新者；
• 刷新语义：TTL 60s 缓存 + in-flight 去重（键含仓根与取数上下文），数据未变返回同一索引实例（引用相等守卫，无刷新循环）；切换仓库 / 登录登出 / 改配置即时失效重取（代次化，登出即隐去徽标）；限流与失败按 60s 退避且失败走既有缓存（无闪烁）；
• 多根工作区：单槽缓存按仓根校验，切库零串仓；
• 配置：hyperGit.branches.pr.enabled（默认开启）总开关；GitHub Enterprise 按已配置的 github-enterprise.uri 实例主机自动判定。

完整叙述见 Branches 视图远程分支 PR 状态徽标。

2. 取数主机策略与注入面加固（#142）

• 取数主机策略：parseGitHubRemote 只辨「GitHub 形态」不辨主机（机制），「是否把 token 发往该主机」的策略由共享谓词 isGitHubInstanceHost 统一落地——CI 状态（status / getStatuses / signIn）与 Branches PR 徽标四个入口全部收口：仅 github.com 与已配置 github-enterprise.uri 的实例主机取数，其余视同非 GitHub（零徽标、零请求）；
• Tooltip 注入面：PR 标题为远程可控文本，行值统一单行化 + 转义 []()<>（封链接 / 图片 / autolink 语法）+ 反引号串按长度压制 code fence；isTrusted 采用空白名单形态（http 链接可点、command: 链接一律失效）；主题图标替换关闭；
• 外链白名单统一：CI 跳转链接与 PR 徽标 Open on GitHub 共用同一主机白名单谓词（github.com、*.github.com、仓库主机、api.仓库主机）；CI openExternal 改用与浏览器同规范的 WHATWG URL 解析，封死 https://evil.com\@github.com/ 类解析器分歧绕过；
• 传输与解析健壮性：请求超时 / 扩展停用中止的保护伞覆盖到响应体读取完成；Retry-After 头全形态解析（非法值不再毒化限流冷却）；远程 URL 含非法百分号序列时容错降级（不再静默打断取数）。

3. 开发依赖升级与 dependabot 聚合（#127–#131）

• @vscode/vsce 3.9.2 → 4.0.0、vitest 4.1.10 → 5.0.1（两项 major 均把 Node 基线抬至 22，与 CI 一致）、ovsx 1.1.1 → 1.2.0、typescript-eslint 8.68.0 → 8.70.0、esbuild 0.28.1 → 0.28.2；五项合成单 PR 重生一次 lockfile；
• .github/dependabot.yml 新增 groups：npm 开发依赖 minor/patch 聚合单 PR（major 仍逐项单开）、github-actions 全量聚合——根除「多个 deps PR 共改 lockfile 连环冲突」的复发源。

⚙️ 升级与兼容

• 无破坏性移除：全部既有命令、视图与配置项保留；本版新增配置 hyperGit.branches.pr.enabled（默认开启，关闭后零徽标零请求）；
• PR 徽标登录入口：复用 Graph 视图标题栏的「登录 GitHub」按钮（需 CI 状态开启，默认开启）——「CI 关 / PR 开」组合下 Branches 视图暂无独立登录入口（已知限制）；
• GitHub Enterprise 用户：PR 徽标与 CI 状态均要求远程主机与已配置的 github-enterprise.uri 实例一致（本版起的安全策略）；
• 徽标覆盖范围：最近更新的 100 条 PR 以内的远程分支（超出窗口的旧分支 PR 静默不显示）；多 fork 同名分支歧义时不显示（宁缺勿错）。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装或更新。
• Open VSX：搜索 Hyper Git - Agentic Git 直接安装或更新（覆盖 Cursor / Windsurf / VSCodium 等 Open VSX 系编辑器）。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.19.vsix → 命令面板 Extensions: Install from VSIX。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG。

许可证：MIT。

Hyper Git - Agentic Git v0.0.18 — Commit / Branches 标题栏重构 · 批量 Discard Changes · 分支级 Push · 双市场发布重启

本版核心：Commit 与 Branches 两视图的头部与标题栏整体重构——Commit 头部两行 UI 上移 VS Code 标题栏（净省两行竖直空间），并新增以文件勾选集为范围的批量 Discard Changes；Branches 的 Push 下放分支右键（按分支推送）、Prune 上移标题栏、Merge… 收入「…」菜单。同时修复无效 codicon 致 Compare with Current Branch 图标渲染空白与文件列表树的 A11y 语义回归，并重启 Open VSX 发布通道，覆盖 Cursor / Windsurf / VSCodium 等编辑器。

✨ 亮点速览

• Commit 头部两行 UI 上移标题栏：Active Changelist 下拉与 ⋯ 管理菜单、List ⇄ Tree 段控全部迁入 VS Code 标题栏，Select All 改为文件列表内吸顶首行——净省两行竖直空间，文件列表可视区随之变长。
• 批量 Discard Changes：Commit 标题栏最左 $(discard) 图标，以文件列表勾选集为范围一次性撤销——单次确认对话框列示目标文件，未跟踪文件删除、已跟踪改动还原，语义与单文件右键 Discard Changes 完全一致。
• 分支级 Push：右键 Branches 视图中任一本地分支即可单独推送——已配置上游时按显式 refspec 推送（本地名与上游名不一致亦正确），无上游时选定 remote 并以 -u 建立追踪。
• Branches 标题栏重排：Push 图标下放右键菜单，「Prune Deleted Remote Branches」上移标题栏 $(sync-ignored) 图标位，「Merge…」收入「…」菜单。
• 活动 Changelist 管理改走 QuickPick：各列表带文件计数、当前活动项预选，分隔线后并入 New / Rename / Delete；活动列表名常驻视图副标题（Default 时省略——无信息量不常驻）。
• 标题栏图标常驻引导：VS Code 默认仅在 hover / 聚焦视图时显示标题栏动作，现提供命令面板开关与首次激活的一次性提示，一键让图标常驻。
• 图标渲染空白修复：Compare with Current Branch 的 $(compare) 并非有效 codicon id，修正为 $(git-compare)；并新增图标名白名单护栏测试，杜绝同类漏出。
• 双市场发布重启：同一枚 VSIX 同时发布至 VS Code Marketplace 与 Open VSX，Cursor / Windsurf / VSCodium 等 Open VSX 系编辑器可直接搜索安装。

🧩 特性详述

1. Commit 视图头部两行 UI 上移标题栏（#120）

原视图头部的两行控件整体迁入 VS Code 标题栏，净省两行竖直空间：

• Active Changelist 选择器：原下拉框与 ⋯ 管理菜单合并为一个 Set Active Changelist… 入口（位于标题栏「…」菜单）——点击弹出 QuickPick，各列表带文件计数、当前活动项预选，分隔线后并入 New / Rename / Delete Changelist… 操作（默认列表不可改名 / 删除）；活动列表名常驻视图副标题（标题「Commit」同行右侧），活动列表为 Default 时省略；
• List ⇄ Tree 切换：原段控改为标题栏 $(list-tree) / $(list-flat) 互斥图标（交互范式与 Graph / Branches 一致），偏好移交扩展宿主 workspaceState 按仓库持久化（hyperGit.commit.dmode:<repo>）；
• Select All 吸顶：复选框改为文件列表容器内的吸顶首行（列表为空时随空态隐藏），原 .cl-bar 与 files-header 两行整体移除。

完整叙述见 Commit 视图整合 与 变更文件目录树。

2. Commit 标题栏批量 Discard Changes（#121）

新增 Discard Changes 标题栏动作（最左 $(discard) 图标），以文件列表勾选集为范围批量撤销：

• 单次 modal 确认，正文列示目标文件（超 10 个截断为 … and N more）；
• 确认后批量执行——未跟踪文件 clean 删除、已跟踪改动 restore 还原，与单文件右键 Discard Changes 走同一条统一路径（单 / 多选语义一致）；
• 勾选集自 webview 单向同步宿主镜像（webview 仍为事实源），无勾选时给出提示而非静默无操作。

同时 Set Active Changelist… 与 New Changelist… 两入口由标题栏图标位收入「…」菜单（0_changelist 组，居同步组之前），把有限的图标位让给高频动作。

3. Branches 标题栏重排与分支级 Push（#121）

• 分支右键 Push（新增）：右键任一本地分支 → Push。已配置上游时按显式 refspec 推送到追踪分支（本地名与上游名不一致亦正确）；无上游时选定 remote 并以 -u 建立追踪——与全局 Push 的双路径语义一致。未配置任何 remote 时给出明确告警；推送全程带进度反馈，完成后刷新视图并提示；
• Push 图标下放：标题栏不再占用图标位（全局 Push 仍可用 Commit 视图标题栏与命令面板）；
• Prune Deleted Remote Branches 上移：由「…」菜单升至标题栏 $(sync-ignored) 图标（即原 Push 位）。该图标全扩展唯一，既区别于同栏 $(refresh) / $(sync) 同步类，也不与右键删除类 $(trash) 混淆；
• Merge… 收入「…」菜单：置于同步组内 Update Project 与 New Tag… 之间，不再占用图标位。

4. 标题栏图标常驻引导（#121）

VS Code 默认仅在 hover / 聚焦视图时显示标题栏动作（平台行为：ViewPane 依 workbench.view.alwaysShowHeaderActions 切换 CSS 类，扩展贡献点无法覆盖）。本版提供双入口：

• 命令面板 Hyper Git: Always Show View Toolbar Icons 随时开启；
• 首次激活的一次性提示——Always Show 写入全局设置并即时生效，Don't Show Again 不再打扰；该设置已为 true 时静默不提示。

5. 稳定性修复（#120 / #121）

• Compare with Current Branch 菜单图标渲染为空白方块：$(compare) 并非有效 codicon id（自 v0.0.17 起即如此），修正为 $(git-compare)。无效 codicon id 在 VS Code 中静默渲染为空白且无任何告警，现以取自 microsoft/vscode-codicons 的图标名白名单护栏测试全量校验命令与 submenu 图标，杜绝同类漏出——该护栏在本版开发期即拦下另一处新引入的 $(sync-ignore)；
• Commit 文件列表树语义回归：吸顶 Select All 行引入后打断了树语义——role="tree" 与 aria-label 回归保留于可聚焦的文件列表容器，吸顶行与行区容器降为 presentation；并补 scroll-margin-top，避免键盘导航的 scrollIntoView 把首行滚到吸顶行之下被遮挡。

6. 发布通道：重启双市场（#119）

CI publish job 增回 Open VSX 发布步骤（由仓库变量 ENABLE_OVSX_PUBLISH 门控，与 Marketplace 的 ENABLE_MARKETPLACE_PUBLISH 对称），复用 package job 产出的同一枚 VSIX、共享同一道 production 审批门——两个市场分发的是字节一致的构建产物。发布决策沿革见 发布策略调研。

⚙️ 升级与兼容

• Commit 文件列表 List / Tree 偏好一次性重置为默认 flat：该偏好自 webview state 移交宿主 workspaceState 按仓库持久化（hyperGit.commit.dmode:<repo>），旧偏好不迁移；勾选集、目录折叠状态与提交草稿均不受影响；
• Branches 标题栏不再有 Push 图标：改为右键任一本地分支执行（新增的按分支推送能力）；全局 Push 仍可用 Commit 视图标题栏与命令面板；
• Branches 的 Merge… 由标题栏收入「…」菜单；「Prune Deleted Remote Branches」反向由「…」菜单上移标题栏图标位；
• Commit 的 Set Active Changelist… 与 New Changelist… 由标题栏图标位收入「…」菜单；活动 changelist 为 Default 时视图副标题不再显示；
• 标题栏图标默认仅 hover 显示属 VS Code 平台行为——若希望常驻，用命令面板的 Hyper Git: Always Show View Toolbar Icons 开启（或在首次激活的提示中点 Always Show）；
• 无破坏性移除：全部既有命令、视图与配置项保留；本版新增 hyperGit.pushBranch、hyperGit.commit.discardSelected、hyperGit.commit.detailTree / detailFlat、hyperGit.alwaysShowHeaderActions 五个命令。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装或更新。
• Open VSX：搜索 Hyper Git - Agentic Git 直接安装或更新（覆盖 Cursor / Windsurf / VSCodium 等 Open VSX 系编辑器）。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.18.vsix → 命令面板 Extensions: Install from VSIX。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG。

许可证：MIT。

Hyper Git - Agentic Git v0.0.17 — Log 提交详情常驻面板 · VS Code 1.136 最佳实践对齐 · 稳定性与体验修复

本版核心：Log 提交详情由悬停浮层升级为右侧常驻面板（三区可拖拽分割），并全面对齐 VS Code 1.136 控件 / 交互 / API 最佳实践——修复 9 项缺陷、Webview 控件全面主题化；新增长时 git 操作进度反馈、入门导览与默认键位、Stash / Worktrees 批量操作、分支 / 标签名即时校验等体验增强。

✨ 亮点速览

• Log 提交详情常驻面板：点击 Graph 提交行即在图右侧常驻打开详情面板——上半 Changed Files（List / Tree 切换、点击打开 Diff），下半提交信息（作者 / 时间、HEAD / 分支 / 远程 / 标签引用分组、完整消息、变更统计、完整 SHA、Open on GitHub）。× 或 Esc 取消选中即收起，刷新 / 重载按仓库记忆恢复；窄视图自动退化为上下堆叠。
• VS Code 1.136 最佳实践对齐（9 项缺陷修复）：Merge 编辑器「保存 → 拒绝强制保存 → 取消」路径失效（acquireVsCodeApi 重复调用）、Commit 草稿丢失（按仓库持久化）、深浅主题切换后 Graph 泳道色停留旧主题、窗口 reload 后 Rebase / Merge 面板空白、git 扩展不可用时视图报错等全部修复。
• 长时操作进度反馈：pull / push / fetch / merge / rebase / cherry-pick / reset 等以 withProgress 呈现进度，失败通知附 "Show Output" 直达 Console。
• 入门导览与默认键位：新增 Get Started 五步导览（walkthroughs）；Alt+B 切换 Blame 注解、Alt+G 打开 Graph 过滤。
• Stash / Worktrees 批量操作：两视图支持多选批量 Drop / Remove（跳过 main 与当前打开项），操作后自动聚焦。
• Graph 工具栏上移标题栏：scope 改图标下拉、仓库路径常驻副标题、多仓库切换与 GitHub 登录图标按钮——省一整行竖直空间。
• Webview 控件全面主题化：滚动条 / checkbox / 下拉 / 阴影 / 字号全部走 VS Code 主题变量（随用户字号设置缩放）；高对比度主题下 Graph 胶囊改描边呈现。
• 文件状态字母标记：● 色点改为 M / A / U / R / D / C 着色字母（色盲可辨，对齐官方 SCM）。

🧩 特性详述

1. Log 提交详情常驻面板（#115）

原 i 悬停浮层整体升级为右侧常驻面板：点击 Graph 提交行即在图右侧于 webview 内水平分栏打开——上半 Changed Files（List ⇄ Tree 切换、点击打开 Diff），下半提交信息（作者 / 时间、HEAD / 分支 / 远程 / 标签引用分组、完整消息、提交者（异于作者时）、变更统计、完整 SHA、Open on GitHub），深浅主题自适应。

• 面板可见性 ⟺ 选中态：× 或 Esc 取消选中即收起；刷新 / webview 重载按仓库记忆恢复选中与面板；
• 窄视图自适应：#main < 560px 时自动退化为上下堆叠（面板 45% / 图区 55%），避免面板把提交图挤成零宽；
• 三区分割线可拖拽：图 ⇄ 面板与面板内 Changed Files ⇄ 提交信息两根 gutter，实时调比例、按仓库记忆、键盘可达（方向键 ±2%、Home / End 归边界）；
• 再次点击已选中的提交行 = 反向操作：收起详情面板（300ms 内双击第二击豁免，保留「双击即打开」语义）。

原悬停浮层与 i 快捷键移除。完整叙述见 Log 提交详情面板。

2. VS Code 1.136 最佳实践对齐（#116，9 项缺陷修复）

• Merge / Rebase 编辑器路径失效：webview 回调内重复调用 acquireVsCodeApi()（每个 webview 仅允许一次，第二次抛异常）——改为脚本顶部获取后全程复用；
• Commit 草稿丢失：视图隐藏销毁后 message / amend / signoff / skipHooks 全部丢失且模板重灌覆盖——webview state 升 v3 按仓库持久化草稿，输入即时落盘，提交成功清空；
• 主题热切换泳道色停留旧主题：泳道色原为启动期一次性快照，补 MutationObserver 监听 body 属性热重算并重渲；
• 分支树文件夹节点出现分支级菜单：11 处 viewItem =~ 正则未锚定误匹配，全部补 ^…$ 锚定；
• CLI 通道失败不可诊断：execFile 丢弃 stderr，现透传挂到错误对象并记入 Console；
• 交互 Rebase 的 reword 可能拉起新 VS Code 窗口：补 ELECTRON_RUN_AS_NODE=1；
• 窗口 reload 后 Rebase / Merge 面板空白：补 registerWebviewPanelSerializer（Rebase 恢复编辑后的 todo，Merge 重拉冲突三阶段）;
• git 扩展不可用时视图报 "no tree view registered"：补空 provider（viewsWelcome 正常触发）；
• Blame 注解：悬浮信息换行折叠（MarkdownString）；split 编辑器无注解、已关闭文档条目泄漏修复。

3. 体验增强

• 长时操作进度反馈：pull / push / fetch / merge / rebase / cherry-pick / reset / updateProject 以 withProgress 呈现（默认标题栏非阻塞）；git 操作失败通知附 "Show Output" 按钮直达 Console；
• 入门导览与默认键位：Get Started with Hyper Git 五步导览（walkthroughs）；Alt+B 切换 Blame 注解、Alt+G 打开 Graph 过滤（Commit 输入框 Ctrl/Cmd+Enter 提交原有内建保留）；
• Stash / Worktrees 批量操作：多选批量 Drop（按 index 降序防位移）/ Remove（跳过 main 与当前打开项）；新建后聚焦对应视图；
• 分支 / 标签名即时校验：git check-ref-format 的 UI 子集纯函数挂接全部 8 处输入框；
• QuickPick 体验：提交选择器 hash 前缀可搜、Rebase / 标签目标分段 Separator、Commit 文件菜单 codicon 图标；
• Commit 文件列表键盘导航：ArrowUp / Down / Home / End / Enter / Escape 容器级焦点；Rebase 拖拽补 Alt+↑/↓ 键盘替代。

4. 工程现代化

• Webview 控件全面主题化：滚动条走 --vscode-scrollbarSlider-*、checkbox accent-color、下拉统一 --vscode-dropdown-*、阴影 --vscode-widget-shadow；字号以 --vscode-font-size 为基准 calc 派生；高对比度主题 Graph 胶囊改描边；Graph 行高 / 泳道列宽常量单源化；
• 文件状态字母标记：● 色点改为 M / A / U / R / D / C 着色字母；8 处 Unicode 字符图标全部 SVG 化；
• 日志通道现代化：两 OutputChannel 迁 LogOutputChannel（自动时间戳与级别），懒创建并随扩展释放；
• 能力声明与设置治理：补 extensionKind: workspace 与 untrustedWorkspaces: unsupported；11 项设置补 scope；palette 补 when 限定；确认对话框多行正文迁 MessageOptions.detail；Shelf 服务全量迁 fs.promises（消除同步 IO 阻塞 UI 线程）。

⚙️ 升级与兼容

• agent 偏好默认值变更：hyperGit.agent.commitPreferences / createPrPreferences / reviewPreferences 默认值由内嵌个人化模板改为空（= 内置默认）——此前默认值中的个人化内容不再分发；已自定义过的用户不受影响；
• Graph scope / List-Tree 偏好一次性重置为默认（All / flat）：偏好自 webview state 移交 host workspaceState 按仓库持久化，旧偏好不迁移（选中与目录折叠不受影响）；
• 悬停浮层与 i 快捷键移除：提交详情统一走点击行的右侧常驻面板；
• 不信任工作区不激活：补 untrustedWorkspaces: unsupported 能力声明（对齐官方安全基线）；
• 无破坏性命令 / 视图变更：全部命令、视图、配置项保留（悬停浮层消息通道为内部实现移除）。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装或更新。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.17.vsix → 命令面板 Extensions: Install from VSIX（Cursor / Windsurf / VSCodium 等用户可经此方式安装）。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG。

许可证：MIT。

Hyper Git - Agentic Git v0.0.16 — 多根工作区仓库切换 · 分支分组树 · Agentic Git 预置

本版是自 v0.0.14 以来的全量积累（0.0.15 版本号已就位但未单独发布，本版一并发布）。四大新特性：多根工作区多仓库切换、Branches 按前缀分组树、Agentic Git 偏好配置与 Claude Code 配置预置（M5 前置铺垫），并修复新增 / 删除 / 重命名文件打不开差异的问题、优化面板默认布局。

✨ 亮点速览

• 多根工作区多仓库切换：Graph 工具栏仓库名成为可切换按钮，一键在多根工作区的多个仓库间切换全局活跃仓库——Graph / Branches / Commit / Stash / Shelf / Worktrees / 未提交角标七视图级联跟随，且 changelist、分支收藏、Shelf、最近提交消息、视图状态全部按仓库隔离记忆，重开窗口回到上次操作的仓库。
• Branches 按前缀分组为文件夹树：Local / Remote / Tags 三段支持「平铺 ⇄ 树」切换，共享前缀的分支收拢为可折叠文件夹（如 feature/1.x.x、feature/2.x.x → 📁feature），远程整体收拢为 origin 文件夹；默认树形、偏好按仓库记忆。
• Agentic Git 预置（M5 前置铺垫）：新增 hyperGit.agent.* 四项偏好（PR 基线分支 + Commit / Create PR / Review 三项 agent 指令模板）与 hyperGit.claudeCode.executablePath 设置（留空自动探测 claude）+ 「浏览 / 打开 Claude 设置」快捷入口。
• Diff 修复：新增 / 删除 / 重命名文件在 Commit 与 Graph 视图可正常打开差异（空树 ref 构造 URI），修复重命名点击崩溃。
• 面板布局优化：Commit / Branches / Graph / Worktrees 依序默认呈现（前两者折叠），Stash / Shelf 默认隐藏（可经视图右键菜单恢复）。

🧩 特性详述

1. 多根工作区仓库切换（#108 / issue #107）

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

• 七视图级联：切换后 Graph / Branches / Commit（changelist）/ Stash / Shelf / Worktrees / 未提交角标全部跟随新活跃仓库刷新；
• 按仓库隔离记忆：changelist 分配、分支收藏、分组偏好、Shelf 存储（旧平铺数据一次性安全迁移：仅 rename、零删除零覆盖）、最近提交消息、Graph / Commit 视图状态（scope / 选中 / 勾选集）均按仓库分区；
• 持久化：活跃仓库记于 workspaceState，重开窗口回到上次操作的仓库。

2. Branches 按前缀分组树（#86）

Local / Remote / Tags 三段支持在平铺与按 / 前缀分组的可折叠文件夹树间切换（工具栏按钮，偏好按仓库持久化、默认树形）。共享前缀的分支收拢到以前缀命名的文件夹下、叶子仅显示末段后缀；远程整体收拢为 origin 文件夹。排序分支感知：当前 HEAD → 收藏 → 同档文件夹优先、名称数字感知升序；并隐藏 origin/HEAD 符号引用（对齐主流 Git UI）。checkout / delete / rename / merge / rebase / compare / favorite 等右键操作全部不受影响。

3. Agentic Git 预置（#88 / #89，M5 前置铺垫）

• 偏好配置：hyperGit.agent.baseBranch（创建 PR 的基线分支，留空=仓库默认分支）+ commitPreferences / createPrPreferences / reviewPreferences（点击 Commit / Create PR / Review 时发送给 agent 的自定义指令，多行文本域、内置默认模板）；
• Claude Code 配置：hyperGit.claudeCode.executablePath（留空=从 PATH 自动探测 claude）+ 命令 Set Claude Code Executable Path…（QuickPick 浏览写回）与 Open Claude Settings（打开 ~/.claude/settings.json，缺失时经确认创建）。

以上为配置层预置，agent/ 接缝与 hyperGit.ai.enabled 行为不变、零破坏。

4. Diff 缺失端修复（#87 / issue #15）

新增文件（无旧端）、删除文件（无新端）此前在新版 VS Code 上打不开差异（readFile 对不存在具名 ref 抛 FileNotFound）。本版改用 git 空树 ref 构造 URI，跨 VS Code 版本稳定解析为空内容；重命名文件两端异路径正确呈现；同时修复 Graph 视图点击重命名文件崩溃的问题。

5. 面板默认布局调整（#101 / issue #16）

六视图默认态微调：Stash / Shelf 默认隐藏（经视图标题右键菜单勾选恢复）、Commit / Worktrees 默认折叠、Branches / Graph 默认展开，顺序调整为 Commit · Branches · Graph · Worktrees。

⚙️ 升级与兼容

• 无破坏性变更：全部特性均为增量新增或纯修复，未移除任何命令 / 配置 / 视图。
• 布局默认仅影响新安装 / 干净 profile：VS Code 会记忆旧布局——老用户升级后如需采用新默认，请执行命令面板「View: Reset View Locations」或右键 Hyper Git 容器页签「Reset Location」（平台行为，同 issue #12）。
• 多仓库数据迁移安全：Shelf 旧平铺数据迁移仅 rename，零删除零覆盖。
• 开发者：包管理器升级 pnpm 11.9.0 → 12.2.1（Rust 重写版，命令 / 配置 / 锁文件格式兼容 pnpm 11）；CI 自动跟随，克隆后 pnpm install 即可。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装或更新。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.16.vsix → 命令面板 Extensions: Install from VSIX（Cursor / Windsurf / VSCodium 等用户可经此方式安装）。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG。

许可证：MIT。

Hyper Git - Agentic Git v0.0.14 — 修复 GRAPH 视图提交记录时间倒序

修复 GRAPH 视图「All」范围下提交记录未按时间倒序排列的问题：此前列表前段日期正常递减，中段却会「回跳」到最新日期——较新的旁支提交被错误地挤到列表底部。本版令提交严格按作者日期倒序呈现，跨分支提交正确交错。

本版为纯取数排序修复，未改动任何 viewType、消息协议、webview.setState 形状、布局算法与配置项，旧状态无需迁移。

✨ 亮点速览

• 提交记录严格时间倒序：GRAPH 视图取数参数由 --topo-order 改为 --author-date-order，从较旧提交分叉、但日期较新的旁支提交不再被「成块」挤到列表末尾，日期列自上而下单调递减、不再回跳。
• 泳道不受影响：DAG 彩色泳道（lane）布局所依赖的「子提交在父提交之上」拓扑不变量在新排序下依然严格成立，连线与分叉渲染保持正确，无断裂、无变形。
• 零协议/交互回归：仅一行取数参数变更，数据协议、布局算法、引用胶囊、悬浮卡、范围切换（All / Current / Checkpoints）、增量加载与过滤（author / grep / path）全部沿用。

🧩 问题与修复

现象

在「All」范围下，提交记录本应严格按时间倒序（最新在顶部）。实际却出现：列表前段（如 2026-07-05 → 2026-05-25）日期正常递减，但中段之后日期回跳回最新的 2026-07-05——一批远端旁支提交（如安全修复、依赖升级等分支）被整块排到了列表底部，与「按时间浏览历史」的直觉严重不符。

根因

GRAPH 视图的提交顺序此前完全由 git log 的 --topo-order（拓扑序）参数决定，管道各层均无二次排序。--topo-order 在保证「子在父之上」的同时，会额外把不同分支的历史「成块」输出——一条分支的提交整块列完，再切到下一条。当仓库存在从较旧提交分叉、但提交日期较新的旁支时，这些提交便被整块下放到列表末尾，形成「日期回跳」。这是 --topo-order 的设计特性，并非按日期排序。

修复

改用 --author-date-order：它同样保证 DAG 泳道算法依赖的「子在父之上」拓扑不变量，但在此约束下按作者日期倒序排列提交，使跨分支提交正确交错。之所以选「作者日期」而非「提交者日期」，是为了与 GRAPH 视图日期列实际显示的时间保持一致——排序键与显示键对齐，避免出现「列内日期看似仍乱序」的二次困惑。

⚙️ 升级与兼容

• 无破坏性变更：仅 GRAPH 视图 git log 取数排序参数变更，未改动 viewType、消息协议、setState 形状或配置项，从 v0.0.13 升级无需任何迁移。
• 即时生效：升级后打开 GRAPH 视图即为新排序，无需重置布局或清理状态。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装或更新。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.14.vsix → 命令面板 Extensions: Install from VSIX（Cursor / Windsurf / VSCodium 等用户可经此方式安装）。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG；本次修复的表因、根因与防范沉淀见 issue #14。

许可证：MIT。

Hyper Git - Agentic Git v0.0.13 — 视图容器迁移至底部 Panel（Terminal 之后）

将 Hyper Git 视图容器从默认的活动栏（Activity Bar / Primary Side Bar）迁移至底部面板（Panel），默认排在 Terminal 页签之后，与官方 Terminal / Output / Problems 提供一致的底部停靠体验。

本版仅变更视图容器的 dock 位置，未改动任何 viewType、消息协议、webview.setState 形状与配置项，旧状态无需迁移。

✨ 亮点速览

• 底部 Panel 停靠：Hyper Git 视图容器从左侧活动栏迁移至底部面板，与 Terminal / Output / Problems / Debug Console 并列；默认页签位置在 Terminal 之后，可拖拽微调。
• 零回归：仅 package.json 单行 dock 变更（activitybar → panel），全部 7 个视图（Commit / Graph / Branches / Stash / Shelf / Worktrees / changesBadge）的 id、源码、图标均不变；webview 渲染、tree provider、命令、菜单、配置项全部沿用。

🧩 完整能力

视图容器：活动栏 → 底部 Panel

• 迁移目标：将 contributes.viewsContainers 的容器 hyper-git 由 activitybar（左侧活动栏）迁至 panel（底部面板）。容器 id 与 views 归属解耦——VS Code 通过容器 id 关联两者，故视图槽位、API 注册、图标规范均无需改动。
• 默认页签顺序：VS Code 平台不提供精确控制 Panel 内页签顺序的能力；新安装扩展的容器默认追加在内置页签（Terminal / Output / Problems / Debug Console）之后。如需调整（例如紧邻 Terminal），可在 Panel 页签栏拖拽 Hyper Git 到期望位置，VS Code 会持久化该布局。

已知边界：未提交计数角标的可见性变化

迁移到底部 Panel 后，活动栏不再保留 Hyper Git 入口图标，因此 issue #10 修复的「面板未打开也持续显示」未提交计数角标随之失效——未提交计数仅在 Panel 展开（且 Hyper Git 页签可见）时呈现。这是 VS Code 平台行为：activitybar 容器图标支持「未聚焦也聚合」的一等 badge，而 panel 容器页签的 badge 受 Panel 展开/收起态约束。

若你希望恢复「始终可见」的未提交计数，欢迎在 GitHub Issues 反馈，可考虑后续提供「双容器（Panel 主面板 + 活动栏轻量角标）」或「状态栏计数器」补救方案。

⚙️ 升级与兼容

• 无破坏性变更：仅 package.json 的 dock 字段变更，未改动 viewType、消息协议、setState 形状或配置项，旧状态无需迁移。
• 老用户需重置视图布局：VS Code 会记忆旧的 activitybar 位置，从 v0.0.12 升级后，Hyper Git 可能仍出现在活动栏。执行以下任一操作即可采用新的 Panel 默认：
  • 命令面板（Cmd/Ctrl + Shift + P）→ 输入 「View: Reset View Locations」；
  • 或在 Panel / 活动栏中右键 Hyper Git 图标 → 「Reset Location」。
• 页签顺序微调：如希望 Hyper Git 页签紧邻 Terminal，在 Panel 页签栏拖拽即可，VS Code 会持久化。

📦 安装

• VS Code Marketplace：搜索 Hyper Git - Agentic Git 直接安装。
• 手动：从 Releases 下载 hyper-git-agentic-git-0.0.13.vsix → 命令面板 Extensions: Install from VSIX（Cursor / Windsurf / VSCodium 等用户可经此方式安装）。

系统要求：VS Code ≥ 1.85.0，且启用内置 Git 扩展（vscode.git，默认随附）。仅支持本地 git 仓库，不支持虚拟 / Web 工作区。

💬 反馈

欢迎在 GitHub Issues 反馈问题与建议。完整工程视角变更记录见 CHANGELOG。

许可证：MIT。