- Inicio
- Plugins
- Mejoras de UI
- dock-git
A
dock-git
aks1st/dock-git
Visualización del historial de Git para el banco de trabajo dock: gráfico de commits por swimlanes, gestión de ramas y etiquetas, operaciones de stage/commit/push y operaciones remotas.
Instalar
dsh plugin --profile web add github:aks1st/dock-gitREADME
dock-git
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 系列插件
dock 生态是一组可组合的插件,本插件只提供其中一块能力。全部可选,按需安装:
| 插件 | 作用 |
|---|---|
| dock-base | 工作台基座:活动栏 / 侧边栏 / 编辑器区 / 状态栏与 ctx.workbench 注册表 |
| dock-files | 文件浏览器:会话工作区目录树、新建/重命名/删除、拖放与粘贴导入 |
| dock-editor | 文本查看/编辑:撤销重做、Ctrl+S 保存、二进制检测 |
| dock-images | 图片查看:PNG/JPEG/GIF/WebP/BMP/SVG/ICO/AVIF |
| dock-markdown | Markdown 查看:GFM 渲染、大纲、相对路径资源 |
| dock-media | 音视频播放:HTTP Range 流式、纯音频播放器与全屏视频 |
| dock-git | Git 历史:泳道提交图、分支/标签、暂存与提交 |
| dock-spreadsheet | 只读表格:XLSX/XLS/ODS/CSV/TSV |
本插件是 dock-git;完整组合建议见 dock-base 的「推荐搭配插件」一节。
安装
需要 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
Plugins relacionados
Z
dsh-web (dsh-task-board)
zhu1090093659/dsh-web
10.6khace 21 horasMejoras de UIApache-2.0
Z
dsh-web (dsh-web-all)
zhu1090093659/dsh-web
10.6khace 21 horasMejoras de UIApache-2.0
C
dsh-TUI
ccch1mneyyy/dsh-tui
8khace 12 horasMejoras de UIMIT
Z
dsh-web-ui (dsh-task-board)
zhu1090093659/dsh-web-ui
6.3khace 3 mesesMejoras de UIApache-2.0