Skip to content

Releases: ThreeFish-AI/hyper-git

v0.0.6

30 Jun 07:28
@github-actions github-actions
v0.0.6
83caf68

Choose a tag to compare

View all tags
v0.0.6 Latest
Latest

Hyper Git - Agentic Git v0.0.6 — 首个 MVP 正式版

为 VS Code 带来统一的 Git 变更管理 与 提交工作流，并为未来 AI Agent 自主代理预留架构接缝。

这是本扩展的首个对外正式版本，在 VS Code Marketplace / OpenVSX 上以 「Hyper Git - Agentic Git」 之名发布。它把开发者高频依赖、却在 VS Code 原生 Source Control 中长期缺失的 Git 工作流一次性补齐：多 Changelist 变更组织、自绘提交面板、可视化提交图、Shelf、行级提交，并与原生 Source Control 平行共存、零冲突。

✨ 亮点速览

  • 多 Changelist 变更组织：把工作区改动分组到命名列表，设活动列表为提交目标，重启自动恢复。
  • 自绘 Commit 提交面板：勾选式提交面板，Conventional Commits 实时校验，Amend / Sign-off / 跳过 Hook，提交或提交并推送。
  • 可视化提交图（自绘 DAG）× CI 状态：彩色泳道、分叉·合并连线、HEAD/分支/标签徽标；每条提交行右侧实时显示 GitHub CI 最终状态（绿勾/红叉/运行中），悬停查看各项检查、失败原因与跳转链接——告别 git log --graph 的粗糙 ASCII，也无需切到浏览器查构建结果。
  • Branches 多选批量操作：框选多个分支/标签，一次性删除、复制引用、收藏；已合并/未合并诚实分栏确认。
  • 独立 Shelf + 全量 Worktree：基于 patch 的 Shelf（独立于 stash）与 Worktree 全生命周期管理（新建/打开/锁定/移动/删除）。
  • 行级与 Hunk 提交：编辑器内 CodeLens「提交此 Hunk」、部分暂存、光标处暂存、Hunk 归属 Changelist。
  • 3-way Merge Editor：自绘三栏冲突编辑器（OURS / RESULT / THEIRS），冲突时一键调起。

🧩 完整能力

变更与 Changelist

按 Changelist 分组的 Changes 树（状态色复用 gitDecoration.* 主题色）；新建 / 重命名 / 删除 / 设活动 / 跨列表移动文件，workspaceState 持久化；单击打开原生 Diff（HEAD ↔ Working）；丢弃改动、加入 .gitignore、显示文件历史。

Commit 提交窗口

多行消息编辑器 + Conventional Commits 实时校验（可配置开关）；Amend、Signed-off-by、跳过 Git Hooks；勾选集即提交权威范围（仅提交选中的文件集合）；最近消息一键复用；提交 与 提交并推送 双动作；提交流水线采用责任链设计（参考 JetBrains CheckinHandler：校验 → 暂存 → Hook 链 → 提交 → 可选推送）。

Log 提交图与历史

自绘 Graph DAG webview（彩色泳道 / 节点 / 连线 / 引用徽标，拓扑保序，虚拟化滚动，↑↓ 键导航）；选中提交内联展开变更文件并打开单文件 Diff；7 个可组合过滤器——作者、路径、message（grep）、message（正则）、合并模式、日期、一键清除；per-commit 操作——复制 hash、Reset 到此、从此新建分支/标签、查看包含此提交的分支、Cherry-Pick、Revert。

提交图 × CI 状态（GitHub Actions / Commit Status）

每条提交行最右侧显示其 CI 最终状态：绿勾=通过、红叉=失败、运行中=黄色旋转。悬停图标以浮层 Tooltip 展示「各项检查 + 未通过原因 + 运行链接」，让你在提交图里一眼看出哪次提交挂了 CI，无需跳转浏览器。

  • 复用 VS Code 内置 GitHub 认证（vscode.authentication），凭证由编辑器托管，绝不经过 chat / 日志 / webview；范围 repo，静默优先、仅点击「登录 GitHub」时才触发原生授权。
  • 性能与限流：仅取可见行懒加载（虚拟滚动 ~50 行）、批量 GraphQL（单次 ≤100 oid）+ 限流冷却；终态整会话缓存、pending 30s 刷新。
  • 零打扰降级：非 GitHub 远程（GitLab 等）零图标零请求；未推送/无 CI 配置 → 不渲染图标；断网/限流不崩溃、建图正常。支持 github.com 与 GitHub Enterprise（按 origin 主机自动判定）。

Checkpointer 过滤

Log 视图新增 Checkpointer 选项，默认剔除 AI 编码工具产生的自动快照（checkpoint）提交，让提交图回归「人写的人类提交」，避免被海量自动提交淹没；可在过滤器面板按需开启查看。

Branches 分支管理

四段分组（收藏 / 本地 / 远程 / 标签）+ ahead·behind·upstream 跟踪展示；新建 / 检出 / 删除 / 重命名 / 合并 / 变基 / 从选中新建并检出；收藏切换、与当前分支比较、任意两分支比较、复制引用、清理已合并分支；多选批量：批量删除分支/标签、批量复制引用、批量收藏（已合并/未合并风险诚实分栏确认）。

标签 Tags

新建（轻量/附注）、删除（支持多选）、检出（进入 detached HEAD）、从提交新建标签。

Stash 与 Shelf

Stash：创建、保留已暂存创建、应用、Pop、删除、从 Stash 创建分支、清空全部，按真实 stash@{n} 索引操作。Shelf（基于 patch、独立于 git stash 的改动搁置机制）：Shelve 暂存、静默 Unshelve、带 3-way 合并 Unshelve、删除。

远程操作

Pull / Push / Fetch（无上游分支自动建立 -u 跟踪）；Push…（normal / force-with-lease / force + 推送标签）、Update Project…（merge / rebase）、Merge…（ff-only / no-ff / squash + 自定义消息）三类对话框；冲突兜底引导与 3-way Merge Editor，以及冲突文件「采用 Ours / Theirs」。

历史编辑与高级操作

Cherry-Pick、Revert、Reset HEAD（soft / mixed / hard / keep）、交互式 Rebase（webview：pick/squash/fixup/drop + reword + 拖拽重排）、撤销最近提交（soft）、删除提交（rebase）、Fixup（autosquash）、改写最新提交信息。

编辑器内能力

行内提交（每个未暂存 Hunk 上方 CodeLens「提交此 Hunk」）；部分暂存 / 取消暂存、光标处暂存、Hunk 归属 Changelist；Blame 行内注解（逐行作者/日期/hash + 悬浮详情）。

工具

导出 / 应用 Patch、查看 Reflog、3-way Diff 概览（HEAD ↔ Staged ↔ Working）、Console 命令输出面板。

配置项

  • hyperGit.commit.template（提交模板）、hyperGit.commit.conventional（CC 校验开关）、hyperGit.ai.enabled（AI 能力开关，M5 预留）。
  • hyperGit.log.ci.enabled / hyperGit.log.ci.remote / hyperGit.log.ci.provider（提交图 CI 状态：总开关 / 查询远程 / 提供者 auto·github.com·github-enterprise）。

规模实证：7 个视图 / 93 个命令 / 6 个配置项 / 280 个单元测试，覆盖 Git 变更管理主线工作流。

🏗️ 架构

采用 路径 B（消费 + 自绘），与原生 Source Control 平行共存、零冲突：

  • 消费 内置 vscode.git 扩展导出的稳定 Repository API 作为 git 底座，不重造 git 状态机。
  • 受控 CLI 通道：稳定 API 未覆盖的能力（cherry-pick / revert / reset / 分支重命名 / hunk 暂存 / stash 列表 / graph 拓扑 / shelf 等）经 GitRepositoryService.execGit 复用同一 git 二进制（api.git.path）实现。
  • 自绘视图 承载完整的变更管理 UI；纯逻辑沉淀于 engine/（零 vscode 依赖、可单测）。
  • AI 接缝：预埋 5 个接口（ILlmProvider / ICommitMessageProvider / IPreCommitInspector / IChangelistGrouper / IConflictResolver，设计参考 JetBrains CheckinHandler 提交生命周期），M5 替换为真实实现，本版未启动。

质量基线：280 个单元测试（engine 纯逻辑）+ 集成测试（@vscode/test-electron + fixture 仓库），CI 三平台（Ubuntu / macOS / Windows）矩阵校验，lint / 类型 / 构建全程 GREEN。

📦 安装

  • 手动安装（当前推荐）：从 Releases 下载 hyper-git-agentic-git-0.0.6.vsix → 命令面板执行 Extensions: Install from VSIX。
  • OpenVSX（Cursor / Windsurf / Gitpod / VSCodium）：搜索 Hyper Git - Agentic Git。
  • VS Code Marketplace：搜索 Hyper Git - Agentic Git（发布上线后可用）。

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

⚠️ 已知限制

  • Commit 窗口的 Co-authored-by / Author 覆盖（--author）/ 撤销最近提交的按钮 UI 接线仍待补（engine trailer 已就绪，仅缺 webview 交互）。
  • Partial 多文件选择 UX、行级 split chunks（按选定行拆分提交）。
  • 目录 / folder diff（虚拟文档）、Submodules 管理。
  • M5 AI Agent：5 个接缝已预埋 Null 实现，本版未启动。

🙏 致谢与许可

图标字形改编自 Tabler Icons（MIT）。完整工程变更见 CHANGELOG。

许可证：MIT。

Assets 3
Loading