前言¶
DSH 的插件機制允許把擴展能力接入 Web UI。社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，也不等同於官方應用商店。對於使用 Agent 修改工作區文件的流程來說，直接在瀏覽器裏查看 Git 變更、執行 stage、commit、revert，比來回切終端更直接。dsh-git-gui 是一個 Git 圖形化界面插件：它可以在瀏覽器中查看、暫存、提交和回退項目變更，並讓使用者即時看到 Agent（harness）對工作區文件的修改。
下面介紹它的定位、核心能力、安裝方式和注意事項。
定位¶
lovetree128/dsh-git-gui 是面向 DeepSeek Harness Web UI 的瀏覽器側插件。它主要解決三個問題：
- 在瀏覽器中查看工作區文件的狀態、行級 diff 和提交歷史。
- 對變更執行 stage、unstage、commit、revert 等常見 Git 操作。
- 在 Agent 修改文件時，提供一個與 Web UI 同側的操作入口。
該插件使用 MIT 許可證。
核心功能¶
變更視圖¶
- 將變更分爲 Staged、Modified、Untracked、Merge Conflicts 四類。
- 查看行級 diff。
- 支持 stage / unstage。
- 丟棄修改或刪除未跟蹤文件時，需要確認。
文件樹視圖¶
- 瀏覽工作區文件，並遵循
.gitignore。 - 按狀態對文件進行顏色區分。
- 支持目錄摺疊和按名稱過濾。
- 可以預覽未修改文件的內容。
提交記錄視圖¶
- 查看提交歷史。
- 支持對單個提交執行
revert。
嵌套倉庫檢測¶
- 當會話工作區不是 Git 倉庫時，插件會查找唯一的嵌套倉庫，並將其作爲操作根目錄。
- 如果檢測到多個嵌套倉庫，插件會提示用戶選擇，而不是自動猜測。
遠程同步與深色模式¶
- 提供遠程同步能力。
- 支持深色模式。
安裝與啓用¶
可以從 GitHub 安裝：
dsh plugin --profile web add github:lovetree128/dsh-git-gui
也可以從 npm 安裝：
dsh plugin --profile web add @amorligno/dsh-git-gui
安裝完成後，重啓 dsh web，並刷新瀏覽器頁面。
更新與卸載¶
更新：
dsh plugin --profile web update @amorligno/dsh-git-gui
卸載：
dsh plugin --profile web remove @amorligno/dsh-git-gui
典型用法¶
1、打開 DeepSeek Harness Web UI。
2、點擊左下角新增的按鈕，打開側邊欄。
3、在側邊欄中查看變更、文件樹和提交記錄。
4、需要時執行 stage、commit、revert，或確認丟棄變更。
適用場景與注意¶
適合在 DSH Web UI 中同時查看 Agent 工作區和 Git 狀態的使用者。使用前注意：
- 插件以當前
dsh進程權限運行，安裝前建議檢查源碼並確認 MIT 許可證。 - npm 包名
@amorligno/dsh-git-gui與 GitHub ownerlovetree128不一致；資料未確認兩者關係，安裝前請自行覈對來源。 - 當面板操作和 Agent 編輯同時發生時，以 Git 自身狀態爲準。
- 會話運行時會顯示警告條；丟棄修改等操作需要確認。
- 未跟蹤文件內容預覽上限爲 512 KiB；diff 輸出上限爲 4 MiB；文件樹最多支持 3,000 個文件。
- 憑據依賴現有 Git credential helpers；交互輸入密碼被禁用，
GIT_TERMINAL_PROMPT=0。 - Windows 上，如果
.git目錄由管理員權限創建，普通權限工具可能需要執行：
git config --global --add safe.directory '<path>'
- 該插件尚未在 macOS 或 Linux 上測試。
- 資料中出現的 branch、stash、merge 等描述，本文不視爲當前已覈實能力。
鏈接¶
- 社區目錄：https://www.skillhub.cn/plugins/lovetree128/dsh-git-gui
- GitHub：https://github.com/lovetree128/dsh-git-gui
