dsh-git-branch：在對話框工具欄只讀顯示 Git 分支

前言¶

DeepSeek Harness（DSH）採用「一切皆插件」的架構。在智能體開發或交互過程中，開發者常需確認當前處於哪個 Git 分支。dsh-git-branch 插件將這一信息直接注入對話框工具行，避免因切換窗口而中斷對話流。

這是什麼¶

這是一個 DSH 客戶端插件，用於在對話框工具行中只讀顯示當前項目的 Git 分支。當目錄不是 Git 倉庫時，該區域不會渲染任何內容，沒有佔位符或報錯。

• 插件名稱：hellohupc/dsh-git-branch
• 維護者：helloHupc
• 許可證：MIT

核心功能¶

1. 位置固定：渲染在對話框工具行，緊跟在權限選擇框之後。
   • 佈局示例：[+ 命令] [權限 ▾] [分支圖標 + 分支名]
2. 只讀顯示：僅展示當前分支信息，不提供任何交互或選擇功能。
3. 智能隱藏：當目錄不是 Git 倉庫、Git 未安裝或探測超時（5秒）時，完全隱藏該組件。
4. 分支類型支持：
   • 正常分支：顯示分支圖標及分支名。
   • 游離 HEAD：顯示分支圖標及 HEAD 的短哈希值。
   • 未提交倉庫：顯示默認分支名。
5. 零輪詢：不進行後臺定時輪詢。僅在會話工作目錄變化、對話結束、標籤頁重新可見時觸發讀取。

安裝與啓用¶

插件以 DSH bundle 形式提供，安裝後自動生效。

前置條件：
* DSH 版本需爲 0.2.0-rc.2 或更新。
* Host 進程的 PATH 環境變量中需包含 git 可執行文件。

安裝步驟：

1. 打開 DSH 的 Web 界面。
2. 進入 Settings → Plugins。
3. 點擊 添加插件。
4. 在目標地址欄中填入：
   • 遠程倉庫地址：https://github.com/helloHupc/dsh-git-branch
   • 或本地 checkout 目錄的路徑。
5. 保存設置。DSH 會自動加載 bundle 並註冊路由。

典型用法¶

安裝完成後，在對話框工具行中即可看到當前項目的 Git 分支信息。該信息由 Host 進程通過路由探測獲取，不涉及任何文件寫入或憑據操作。

適用場景與注意¶

• 適用場景：需要快速覈對當前工作分支的開發者；希望保持對話界面整潔，避免雜亂信息的用戶。
• 安全說明：該插件通過本地 HTTP 載體暴露倉庫信息。路由訪問受 DSH 的 Host 防線限制，僅允許迴環地址或受信任的 Host 訪問，拒絕跨站請求。
• 依賴說明：插件不依賴複雜的構建步驟或運行時庫，僅需系統環境中有 git。

結語¶

dsh-git-branch 提供了一種輕量級、低侵入的方式將版本控制信息集成到 DSH 的對話界面中。它通過 Host 路由探測實現數據獲取，既保證了信息的實時性，又避免了輪詢帶來的資源消耗。

• GitHub 倉庫
• 插件目錄