dock-git

English

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

dock 系列的 Git 历史可视化插件：在侧边栏挂载启动面板（活动项 git），渲染当前工作区 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