前言¶
在使用 DeepSeek Harness (DSH) 進行開發時，Git 倉庫的提交管理往往是打斷對話流的一個環節。傳統的做法是切換終端、運行 git 命令，或者手動複製粘貼 diff 信息。DSH 的設計理念是「一切皆插件」，社區開發者 135ty 提供了一個名爲 dsh-git-commit-panel 的 Web GUI 插件，旨在將 Git 提交操作直接集成到 DSH 的網頁界面中，通過懸浮膠囊的形式，讓改動一目瞭然，提交信息可以手寫也可以由 AI 起草，實現一鍵提交。
插件定位¶
這是一個運行在 DSH Web / CLI 環境下的插件，由開發者 135ty 維護。它解決的核心問題是：在 DSH 的 Web 界面中，如何直觀地查看當前對話工作區的 Git 變更，並方便地完成提交或推送操作。
核心功能¶
-
懸浮膠囊通知
噹噹前對話所在目錄的 Git 倉庫有未提交改動時，DSH 網頁界面會浮出一枚膠囊。它顯示當前分支名稱、待提交的文件數量以及增刪行數（例如⑂ main 6 個更改 +61 -5）。如果工作區乾淨或目錄不是 Git 倉庫，膠囊不會出現。 -
提交信息處理
提交信息支持兩種方式：手寫輸入，或者點擊「AI 生成」。如果留空直接點擊提交，插件會自動調用 AI 根據變更內容生成符合規範的提交信息。
提交信息遵循 Conventional Commit 規範：首行是 type 與 scope（使用英文），主題不超過 72 字符。 -
提交與推送
提供兩個主要動作：「提交」和「提交併推送」。插件行爲對齊 ZCode 的 Git 工具，支持在提交前選擇是否暫存全部更改（包括未跟蹤文件）。 -
語言與主題
插件界面支持中英雙語，跟隨 GUI 的語言設置；同時跟隨界面的淺色或深色主題。
安裝與啓用¶
本插件不發佈 npm 包，只從 GitHub 分發。推薦使用預編譯的 Release 包以避免本地構建的麻煩。
前提條件：
* DeepSeek Harness 版本 >= 0.2.0-rc.1
* Host 的 PATH 環境變量中包含 git
安裝步驟：
1. 執行以下命令安裝插件（使用預編譯包）：
dsh plugin --profile web add https://github.com/135ty/dsh-git-commit-panel/releases/latest/download/dsh-git-commit-panel.tgz
- 安裝完成後，需要重啓
dsh web進程以使插件生效。
從 GitHub 源安裝（需構建）：
如果需要安裝源碼或釘定特定版本，可以使用以下命令：
dsh plugin --profile web add github:135ty/dsh-git-commit-panel
注意：從 GitHub 源安裝會下載源碼並在本地構建。由於 pnpm 的安全策略，首次從源碼安裝需要配置 pnpm-workspace.yaml 中的構建授權。
注意事項¶
- 安裝範圍：此插件只能在
dsh web或 CLI 環境下安裝。DSH Desktop 客戶端僅接受已發佈到 npm 的包，因此無法通過 GitHub 源安裝此插件。 - 作用域限制：插件只識別當前對話所在的工作區。如果切換到其他對話或非已註冊工作區，膠囊不會出現。
- 運行環境：插件只在本機環境生效，且僅對已註冊的工作區有效。由於瀏覽器安全限制，不能指定任意目錄來運行 git 命令。
總結¶
這個插件通過 UI 懸浮組件，將 Git 提交流程無縫嵌入 DSH 的工作流，利用 AI 輔助生成規範化的提交信息，適合習慣在瀏覽器中進行代碼管理的 DSH 用戶。
