前言¶
在 DeepSeek Harness Web 中和 Agent 處理代碼任務時，Git 操作常常還要切回終端：查看狀態、確認 diff、暫存文件、提交、切換分支，再覈對 Agent 是否理解正確。DSH Git Plugin 把這些動作放進 Web 工作臺：一邊查看倉庫狀態和提交歷史，一邊執行常用 Git 操作，或者審查 Agent 生成的分步驟命令提議。
這是什麼¶
DSH Git Plugin 是面向 DeepSeek Harness Web 的可視化 Git 工作臺，由 IT-coder-Yy 維護，倉庫名爲 IT-coder-Yy/dsh-git-plugin。它用於查看倉庫狀態與提交記錄、快捷執行常用 Git 操作，並安全運行自然語言生成的分步驟命令提議。
已覈實的安裝命令使用包名 dsh-easygit-plugin，許可證爲 MIT。
最後驗證信息：2026-08-20，DeepSeek Harness 0.1.0-rc.8，dsh-easygit-plugin 0.2.3。
核心功能¶
下面介紹已覈實的能力。
查看倉庫狀態¶
可以看到當前分支、已暫存與未暫存文件，以及格式化 review 視圖或 raw diff。
查看提交歷史與詳情¶
可以查看提交圖、message、author、timestamps、parents、changed files、statistics、full diff。
執行常用 Git 操作¶
支持 stage/unstage 單個或多個文件、創建 commit，以及創建、搜索、切換、安全刪除本地分支。
遠程同步與 rebase¶
支持查看 upstream、ahead/behind、工作樹狀態；執行 fetch、fast-forward pull、push、爲分支設置 upstream，或安全開始、繼續、中止 rebase。
查看分支與 tags¶
可以查看本地分支、遠程分支和 tags。
自然語言生成命令提議¶
可以把自然語言請求轉換爲分步驟 Git 命令提議，可直接執行，也可以複製後手動執行。
失敗處理¶
失敗時保留失敗命令、輸出與倉庫診斷；對識別失敗提供安全恢復提議，或交給 Agent 分析複雜失敗。
默認安全¶
包括 allowlist 校驗、高風險操作確認、防止提議重放，以及從診斷中隱藏常見憑據。
安裝與啓用¶
先爲 Web profile 添加插件：
dsh plugin --profile web add dsh-easygit-plugin
然後啓動 DSH Web：
dsh web
使用前提是：需要 Node.js ^22.19.0 || >=24.0.0、Git，以及支持靜態 Cordis 插件的 DeepSeek Harness developer preview release。
典型用法¶
1、在 DSH Web 的 composer 旁邊使用 Git 按鈕，查看變更、審查提交歷史、stage 文件、提交變更、管理分支，或與遠程同步。
2、對 Agent 提出 Git 操作。例如：
Commit the documentation update to the current branch with the message "docs: update guide"
生成的是分步驟命令提議，可以直接執行，也可以複製手動執行。
3、涉及 rebase 或強制刪除分支時，需要明確風險確認。
適用場景與注意¶
這個插件適合在可信倉庫和可信 Git 配置中使用，尤其是需要在 DSH Web 中查看狀態、執行常規 Git 操作，或審查 Agent 提議的場景。
使用前注意：
- 插件隨當前 DSH 進程運行，執行 Git 命令時會遵循 DeepSeek Harness 提供的 Shell 與 sandbox 策略。
- 每一步必須恰好包含一個允許的 git 子命令。
- Shell 控制符、命令替換、重定向、可執行 hooks 和不安全 Git 選項會被拒絕。
- 高風險操作，包括歷史重寫，需要明確確認，且提議只能執行一次。
- 診斷中會隱藏常見憑據。
- 安裝前應檢查源碼與
MIT許可證；安全漏洞需按SECURITY.md私下報告。
結尾¶
DSH Git Plugin 的價值在於把“看狀態、做操作、審 Agent 提議”放在同一個 Web 工作臺裏，並給自然語言生成的 Git 命令加上了確認和執行限制。
GitHub：https://github.com/IT-coder-Yy/dsh-git-plugin
目錄頁：如從社區目錄安裝，請以目錄頁實際給出的插件條目和安裝命令爲準。
