在 DeepSeek Harness Desktop 中，開發者通常需要快速瞭解當前會話工作區的分支狀態。手動執行 git status 或在終端切換分支會打斷對話流。dsh-git-branch 插件通過對話欄的膠囊形式，提供了一種直觀的分支查看與切換方式。
這是一個面向 DeepSeek Harness Desktop 的對話欄插件。它能在 Composer 左側顯示當前工作區的分支狀態，點擊後展開本地與遠程分支列表，並在確認後進行切換。插件由 Rock-ql 維護，採用 MIT 許可證。
核心功能¶
- 對話欄膠囊：在 Composer 左側顯示當前分支名稱、游離 HEAD 狀態、工作區是否有未提交改動（dirty 圓點），以及相對上游的領先/落後標記（↑ / ↓）。
- 分支列表交互：點擊膠囊展開本地與遠程分支列表，支持關鍵詞過濾，支持鍵盤上下鍵選擇、Enter 確認、Esc 取消。
- 分支切換：支持切換本地分支；對於遠程沒有本地跟蹤的分支，執行
checkout -t創建跟蹤分支。 - 新建分支：可以從當前 HEAD 快速新建分支並切換過去。
- Fetch 選項：切換前可確認是否執行 Fetch 操作。
- 錯誤處理：切換失敗（包含未提交改動衝突等）時直接展示 Git 的原始錯誤信息，不會使用
--force強制覆蓋。
安裝與啓用¶
- 使用官方倉庫安裝：
dsh plugin --profile desktop add github:Rock-ql/dsh-git-branch
- 安裝後重啓 DSH Desktop。
- 如需本地開發或調試，可使用本地路徑安裝：
dsh plugin --profile desktop add /Users/rockcoder/Documents/project/dsh-git-branch
*注：Web profile 只需將 `desktop` 替換爲對應的 profile 名稱即可。*
典型用法¶
- 打開 DSH Desktop，進入任意 Git 倉庫目錄。
- 在 Composer 左側查看分支膠囊，確認當前狀態（如 dirty 圓點）。
- 點擊膠囊，在彈出的列表中通過鍵盤導航或搜索過濾查找目標分支。
- 按 Enter 確認切換。
適用場景與注意¶
- 適用場景：需要在對話式界面中快速確認並切換 Git 分支的開發者。
- 注意：
- 非非 git 倉庫目錄下，插件不會渲染。
- 插件不給模型註冊任何 git 工具，不會自動執行 fetch、pull 或 push 操作。
- 插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證（MIT）。
結語¶
通過在對話欄集成 Git 狀態與切換能力，該插件降低了上下文切換的認知負擔。更多插件詳情與源碼，請訪問 插件目錄 或 GitHub 倉庫。
