在 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 環境中進行安全使用。