DeepSeek Harness(DSH)適合讓多個 Agent 在不同 Worktree 中並行工作。但在終端裏僅通過 git log 很難同時回答分支來源、WIP 對比以及 Agent 會話狀態等問題。dsh-gitKraken 將這些信息整合進 DSH 原生的 Git Graph 標籤頁,提供可視化的歷史圖譜和安全的 Workbench。
該插件由維護者 nateEc 維護,開源協議爲 MIT。
環境要求¶
需要 Node.js >= 22.19.0 和 DeepSeek Harness >= 0.1.1-rc.2。
安裝¶
在目標 profile 中執行以下命令:
pnpm add '@nateec/dsh-gitkraken@github:nateEc/dsh-gitKraken#1b7cda88f3bba07e859a653d15d46b9db2238e14'
安裝完成後,用你的 profile 固定版本重啓 DSH,打開任意 Git 工作區的會話,頂部會出現 Git Graph 標籤頁。
核心功能¶
- Git Graph:提供多分支 DAG、分支/標籤/遠端引用、作者與變更統計、服務器端分頁、Repository Sonar Minimap 以及縮放與跳轉功能。
- Search & Filter:支持
message:、author:、file:、change:、commit:、@me等搜索過濾,支持大小寫、正則、全詞匹配和跨分頁結果導航。 - Inspect & Compare:展示提交詳情、歷史文件 Diff、完整 Patch 和 Multi-diff,支持 Commit/Branch/WIP 任意兩點對比。
- WIP & Commit:支持逐文件暫存/取消暫存、Stage All、Copy Patch、Commit Composer 以及創建與切換分支。
- Agent Workspaces:展示多 Worktree WIP、AgentTeams Kanban、Agent Activity、普通與子代理 DSH 會話狀態及直達鏈接。
- Safe Workbench:提供 Stash、Undo Commit、Rebase 預覽、恢復引用以及衝突的 ours/theirs 選擇,支持 Continue/Abort。
- DSH Model Tools:使用當前 DSH 會話 Provider 生成 Review、Explain 與 Changelog,不讀取或複製模型 API Key。
- Remote:支持 Fetch、僅快進 Pull、普通 Push;可選的 GitHub/GitLab Pull Request Provider 默認關閉。
典型用法¶
- 在 DSH 中打開一個真實 Git 倉庫的會話。
- 切換到 Git Graph 標籤頁。
- 在 Graph 中搜索、篩選、選擇提交或 WIP;在右側 Inspector 中查看文件和 Diff。
- 切到 Agents 頁面查看所有 Worktree、AgentTeams 任務與 DSH 會話。
- 切到 Workbench 執行批量暫存、Stash、模型審閱或帶恢復點的歷史操作。
搜索語法示例¶
message:fix timeout:搜索提交信息包含指定文本的提交。@me:搜索當前 Git 用戶提交的內容。file:src/client:搜索改動過指定路徑的提交。
安全與限制¶
該插件執行真實 Git 操作,安全約束屬於產品功能,而非附註:
- 後端只接受 DSH 已註冊工作區的真實路徑,HTTP 接口只允許本機迴環訪問。
- Git 命令始終使用參數數組執行,不經過 shell 拼接。
- Pull 只允許 fast-forward;Push 不提供 force 模式。
- Undo Commit 僅在乾淨工作區執行 soft reset,文件變化會保留在暫存區。
- Rebase 要求工作區乾淨、當前分支非 detached,並在改寫前創建恢復引用和精確確認。
- Stash 使用保留式 Apply,不自動 Pop;恢復操作不會執行 hard reset。
- 當前不提供 Discard、刪除本地/遠端分支、force push 或跳過 hooks。
- 沒有遙測或自動更新邏輯。
- GitHub/GitLab Provider 默認關閉,私有倉庫只讀取插件專用的環境變量 Token,不會返回瀏覽器或複用 DSH 模型憑據。
項目倉庫:https://github.com/nateEc/dsh-gitKraken