在 DeepSeek Harness (DSH) 環境中，直接處理 Git 操作通常依賴外部命令或依賴複雜的上下文傳遞。dsh-git-plugin 插件將 Git 工作流集成到 DSH 會話中，通過 Web 面板和斜槓命令，提供查看倉庫狀態、分支管理、差異檢查、提交以及恢復快照的能力。
核心能力¶
該插件通過 Web 面板和命令行接口，爲用戶和模型提供以下功能：
- Web Git 面板：在 Web 界面右側側邊欄中，可以直接查看分支、文件狀態、暫存與未暫存的差異以及提交歷史。支持在面板中暫存文件、管理分支和暫存，每次寫入操作都會打開預覽並需要確認。
- 斜槓命令：支持通過命令行快速執行常用 Git 操作。
- 只讀工具：模型可以使用
git-status、git-diff、git-log、git-show等工具來獲取倉庫信息。 - 暫存快照：通過
/undo命令創建、列出或恢復 stash 快照。 - 預提交檢查：支持在提交前進行相關檢查。
安裝與啓用¶
使用以下命令安裝插件。請將 web 替換爲你當前使用的 profile 名稱。
dsh plugin --profile web add dsh-git-plugin@0.4.0
安裝後，重啓對應 profile 的 DSH 進程並刷新瀏覽器，即可在 Web 界面中使用 Git 面板。
使用方式¶
斜槓命令¶
| 命令 | 功能說明 |
|---|---|
/status |
查看當前分支和工作樹狀態 |
/diff |
查看暫存和未暫存的變更摘要 |
/branch [<name>] |
列出分支，或創建並切換新分支 |
/commit [<message>] |
顯示提交引導或執行檢查並提交 |
/undo [list\|pop] |
創建、列出或恢復暫存快照 |
模型工具¶
模型可以使用 git-status、git-diff、git-log、git-show 等只讀工具來輔助決策。
操作範圍與注意事項¶
- 提交範圍：Web 面板中的提交操作僅使用暫存區的內容；而
/commit命令會在提交前暫存目標倉庫中的所有更改。 - 撤銷操作：
/undo命令會暫存工作區的更改，包括未跟蹤的文件。它不會回退提交。使用pop恢復快照時可能會產生衝突。
環境要求與限制¶
- 系統依賴：需要 Node.js ≥ 20 和 Git ≥ 2.32。
- DSH 版本：已驗證在 DSH 0.2.0-rc.2 上運行。
生態位置¶
該插件由社區用戶 MashedPotato817 維護，遵循 MIT 許可證。DSH 生態強調“一切皆插件”，該插件旨在讓智能體在會話中直接擁有對 Git 倉庫的完整操作視圖。
