前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許用戶擴展功能。在開發或調試過程中，頻繁切換 Git 分支是常見操作。通常這需要離開 DSH 界面，回到終端執行命令。dsh-git-branch-manage 插件解決了這一割裂問題，它將 Git 狀態直接集成到會話界面，並提供菜單化的分支管理入口，減少工具切換的頻率。
插件概覽¶
這是一個 DeepSeek Harness (DSH) 插件包，由維護者 LongSir0419 開發。它主要實現了一個“Git 分支徽章”，在會話頭部和新會話歡迎頁顯示當前分支名稱，並支持通過點擊和右鍵菜單進行分支的切換、創建、拉取、推送和刪除操作。
核心功能¶
插件提供了一整套 Git 分支交互能力，具體如下：
- 分支展示
當前 Git 分支會顯示在會話頭部（Session Header）以及新會話的歡迎頁上。 - 左鍵菜單
點擊徽章可打開分支列表菜單。- 菜單支持顯示本地分支和遠程分支。
- 列表採用 IDEA 風格的目錄樹結構。
- 本地分支列表僅展示最近 7 天內活躍的分支。
- 右鍵菜單
在分支徽章上點擊右鍵，可快速執行以下操作：切換分支、拉取、獲取和推送。 - 創建分支
在菜單中選擇創建分支時，插件會先拉取當前分支，隨後創建並切換到新分支。創建過程中會提供前綴建議。 - 刪除分支
- 僅支持刪除本地分支。
- 使用安全刪除模式（
-d），不會強制刪除遠程分支。 - 系統會拒絕刪除當前所在的分支以及遠程分支。
- 交互反饋
- 切換分支前會彈出確認對話框。
- 操作執行期間（如拉取、推送）顯示點狀加載動畫。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add @wanghailong0419/dsh-git-branch-manage
安裝完成後，重新打開 DSH Web 客戶端，插件會自動生效。
典型用法¶
安裝成功後，在 DSH 的會話界面中，你可以在頂部欄看到當前分支的徽章。
* 查看分支：左鍵點擊徽章查看分支列表。
* 切換分支：在列表中點擊目標分支。
* 執行操作：右鍵點擊徽章，選擇 Pull、Push 或 Switch。
適用場景與注意¶
該插件適合需要在 DSH 界面內直接管理 Git 分支的開發者。使用前請注意：
* 插件通過 DSH 進程權限運行，操作具有終端命令的效力。
* 刪除分支功能僅限本地分支，且拒絕刪除當前分支，請確認操作目標。
* 使用前建議查閱源碼與許可證（MIT）。
總結¶
dsh-git-branch-manage 通過將 Git 分支信息可視化並集成到 DSH 交互流中，簡化了分支管理的流程。如果你在 DSH 中頻繁處理代碼，這個插件可以作爲一個輕量級的輔助工具。
