在 DSH 工作台中直接管理 Git 仓库通常需要切换到本地终端。dock-git 插件通过在侧边栏挂载启动面板(活动项 git),将 Git 历史可视化和仓库操作直接集成到 Web 环境中。该插件由 AKS1st 维护,旨在提供一种比原生 Git 工具更直观的方式来查看提交历史、管理分支和处理代码变更。
核心功能¶
- 泳道式提交图:展示分支/标签/远端引用徽标以及未提交改动节点。
- 提交详情:三栏对比,显示提交信息、作者、变更文件树以及旧/新文件内容。
- 多仓库发现:扫描当前工作区(cwd 及其两层子目录)内的独立 Git 仓库。支持在仓库列表中切换目标仓库。
- 分支与标签管理:支持创建、重命名、删除分支,创建/删除标签,检出分支,以及本地分支合并。
- 暂存与提交:提供类似 VSCode 的 status/stage/unstage/commit 操作。
- 提交重置与回退:支持混合/软/强制 reset 以及 revert 提交。
- 远端操作:支持 list/add/remove/set-url、fetch、pull、push。
- 配置读写:读取任意仓库配置;写入仅限
user.name/user.email。 - 多语言:内置中英文界面。
安装与启用¶
需要先安装 dock 基础插件,再安装 dock-git。
dsh plugin --profile web add dock-base
dsh plugin --profile web add dock-git
典型用法¶
- 在侧边栏挂载启动面板(活动项
git),渲染当前工作区 git 仓库的提交历史图。 - 点击提交展开详情,查看提交信息、作者、变更文件树及三栏 diff。
- 在多仓库工作区中切换目标仓库。
依赖与注意事项¶
- 依赖:需要
dock>= 0.1.0(必需)及系统git命令行。 - 安全:
repoRoot限定在会话工作区内;git 参数有白名单校验;大输出流式传输。 - 可选搭档:不需要
dock-files。
dock-git 将 VSCode 的 Git 面板风格带到了 DSH 工作台中,提供了一个集成的 Git 历史查看器和仓库管理器。其安全措施确保了操作限制在会话工作区内,适合在 Web 环境中进行安全使用。