Git 提交历史图 AKS1st/dock-git

dock-git

DSH 生态中最好的 Git 历史可视化插件 —— 没有之一。 泳道式提交图、分支/标签徽标、三栏 diff、暂存提交推送、远端管理，把 VSCode 的 Git 面板直接搬进 DSH 工作台。在 DSH 里看仓库、管分支、推代码，dock-git 就是终极武器。

dock 系列的 Git 历史可视化插件：在侧边栏挂载启动面板（活动项 git），渲染当前工作区 git 仓库的提交历史图（提交图 / 分支 / 标签 / 远端），并支持分支、标签、配置、远端、暂存、提交与推送操作。

效果预览

dock-git 提交历史图（中文界面）

功能

- 提交历史图：泳道式提交图，展示分支/标签/远端引用徽标、未提交改动节点；N+1 探测「更多提交」。
- 提交详情：点击提交展开详情——提交信息、作者、变更文件树（新增/修改/删除/重命名）、旧/新文件内容三栏对比、diff（512 KiB 截断，UTF-16 安全）。
- 多仓库发现：扫描会话工作区（cwd 及其两层子目录）内的独立 git 仓库，可切换目标仓库；仓库列表直接标注各仓库当前分支。
- 分支/标签管理：创建、重命名、删除分支，创建/删除标签，检出（git switch，无路径语义歧义）；本地分支之间可互相合并（git merge --no-edit，拉到当前分支）。
- 暂存与提交：VSCode 风格 status/stage/unstage/commit（--no-verify，不执行仓库钩子）。
- 提交重置与回退：在提交上右键可选择重置模式（混合 / 软 / 强制）执行 git reset，或回退提交（git revert --no-edit，创建反向提交）。
- 远端操作：list / add / remove / set-url、fetch、pull、fetch-into、push（分支/标签，支持 --force-with-lease）。
- 配置读写：读取任意仓库配置；写入仅限 user.name / user.email。
- 多语言：内置中英文界面，跟随 DSH 全局语言设置。

依赖

| 依赖 | 类型 | 说明 |
| dock >= 0.1.0 | peer（必需） | 工作台外壳：侧边栏面板、编辑器区视图、ctx.workbench 由它提供 |
| git 命令行 | 系统运行时 | 必需：所有 Git 操作通过 spawn 调用系统 git，需在 PATH 中可用 |
| DSH Web 环境 | 运行时 | 必需，客户端平台为 Web |
| cordis ^4.0.0-rc.7 | peer | 插件框架（DSH 自带） |
| react ^18.2.0 | peer（可选） | 客户端渲染需要；未提供时面板 UI 不激活 |

可选搭档：dock-git 与文件浏览完全独立，不需要 dock-files；若同时安装 dock-files 及查看器插件，提交详情里的文件可无缝衔接工作台打开。

安装

需要 dock 基础插件：

推荐从 npm registry 安装：

dsh plugin --profile web add dock-base
dsh plugin --profile web add dock-git

或通过 GitHub 安装（备选）：

dsh plugin --profile web add github:AKS1st/dock
dsh plugin --profile web add github:AKS1st/dock-git

安全

- /wb-git 路由只接受受信任来源（回环地址 / trustedHosts + 同源检查）的 POST。
- git 一律以参数数组直接 spawn（无 shell 字符串），环境变量消毒（清掉 GIT_DIR / GIT_WORK_TREE，固定 C locale）。
- 所有用户可控的 argv 位置都有白名单校验：ref 名、远端名、config key、暂存路径、提交消息等；拒绝前导 -（选项注入）、.. / @{（范围/refspec 走私）、路径规格 magic（:）、控制字符与 NUL。
- repoRoot 限定在会话工作区内（realpath 前缀比较），不能在任意目录执行 git。
- 大输出命令（log / diff / show / status）带流式字节上限，超出即终止子进程，避免拖垮宿主。
- 检出用 git switch，绝不回退到路径语义（不会误恢复工作区文件）。

License

MIT