前言¶
在 DeepSeek Harness（DSH）裏用 AI 改代碼時，常見打斷來自 Git：切到終端做 pull、stage、寫提交信息，再切回會話，上下文容易斷掉。終端或獨立 Git 客戶端能完成這些事，但按鈕多、步驟散，和「邊聊邊改」的節奏不對齊。下面介紹客戶端插件 WDX Git（dsh-wdx-git），它把 Git 面板放在 DSH 右側欄，用一個同步按鈕處理 fetch / pull / push，默認打開提交頁並全選改動，還可讓 AI 根據本次 diff 寫提交信息。
這是什麼¶
WDX Git 是 DSH 右側欄裏的 Git 面板，維護者爲 wdxtub，在插件目錄中歸類爲客戶端。README 將其定位爲：AI 改完代碼後不必切終端，也不必在一排 Pull / Push / Fetch 裏做選擇；交互思路參考 GitHub Desktop 裏順手的一部分，但爲 DSH 會話重新設計，不是完整的 GitHub Desktop 替代品。
- 倉庫：wdxtub/dsh-wdx-git
- 目錄頁：SkillHub 插件頁
- 許可：MIT（資料註明適用於 DSH 0.2.x，支持 macOS / Windows / Linux）
- npm 包當前版本（
package.json）：0.1.4；運行要求 Node>=22，DSH>=0.2.0 <0.3.0
插件在本機執行 Git 操作；私有倉庫依賴你機器上已有的 git 憑據。安裝前建議自行查看源碼與許可證——插件以當前 DSH 進程權限運行。
一個同步按鈕¶
頂欄保留倉庫名、分支名和一個同步按鈕。按鈕文案隨倉庫狀態變化，點一次由插件按順序完成所需步驟（fetch → 補 upstream → 快進或合併 → 需要時推送）。
| 狀態 | 按鈕顯示 |
|---|---|
| 已與遠端同步 | Fetch origin |
| 只落後遠端 | Pull origin |
| 只有本地提交 | Push origin |
| 本地與遠端都有新提交 | Sync |
| 尚無 upstream | Publish branch |
落後或領先遠端時，按鈕內會出現帶方向箭頭的計數：↓ 表示待拉取的遠端提交，↑ 表示待推送的本地提交。工作區有未提交改動時，同步前會自動 stash，合併後恢復；push 被拒時會自動重試一次（fetch + merge + 再 push）。不 force push，不自動 rebase，不改寫已有歷史；遇衝突才停下來，由你在面板裏處理。
提交頁默認在前，改動默認全選¶
打開面板先看到提交表單：Summary 一行、Description 單獨一行，AI 區域與提交按鈕依次排開。所有改動默認勾選；取消某個文件則只留在工作區，不會進入本次提交。提交時僅暫存選中的路徑。
AI 可生成提交信息，分兩種風格：
- 快速：一句話 Conventional Commit，適合日常小改；
- 詳細：補充原因、行爲變化、限制與驗證信息。
默認跟隨當前會話模型；也可在設置裏換更便宜的模型。AI 只讀本次會提交的 diff 及相關上下文，不替你做提交或推送，最後一步仍由你確認。
變更、歷史、分支與衝突¶
除提交與同步外，README 還說明面板支持：
- 變更 / 差異：逐文件查看，詞級高亮 diff；
- 歷史：SVG 提交車道圖、提交搜索；
- 分支與 Stash：分支切換等；
- 衝突：查看 ours / theirs，AI 生成合並建議（僅預覽，確認後寫入）、取某一側或手工修改後「標記爲已解決」；支持中止或繼續 merge / rebase / cherry-pick / revert。
界面顏色來自 DSH 主題 token，深淺主題自動適配。macOS 可自動讀取系統 HTTP/HTTPS 代理；其他平臺尊重 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY 或 git 的 http.proxy。Git 數據留在本機，README 寫明插件不保存 token、不做遙測。
插件刻意不做的事項包括：hunk / 行級 partial staging（僅到文件級）、遠端選擇 UI（多遠端時優先 origin）、繞過 hooks、commit signing、後臺自動提交等。
安裝與啓用¶
從插件頁安裝（推薦）¶
在 DSH 側欄打開 插件 → 添加插件，輸入包名：
dsh-wdx-git
安裝源選 npm 官方源，裝好後點 立即啓用。若鏡像未同步，可切換安裝源再試。npm 包主頁：https://www.npmjs.com/package/dsh-wdx-git。
從源碼安裝¶
若你從 GitHub 拉取源碼本地安裝，README 給出的命令爲：
git clone https://github.com/wdxtub/dsh-wdx-git.git
dsh plugin --profile desktop add ./dsh-wdx-git
安裝後刷新頁面。若更新了 Host 代碼（index.js / src/），需重開 DSH 讓 Host 重新加載；僅刷新頁面只更新客戶端部分。
啓用後入口有兩處：
- 會話頭部工具欄的 Git 分支圖標；
- 右欄 + → 開始 →「WDX Git」。
典型用法¶
按 README「上手」步驟，可這樣走一遍：
- 打開任意會話的 Git 面板；默認在「提交」頁。
- 看頂欄按鈕是 Fetch origin / Pull origin / Push origin / Sync 中的哪一種，點一下完成與遠端的同步；需要時會自動合併、推送。
- 填寫 Summary，或點 AI 生成。
- 點「提交 N 個文件到 main」；勾選「提交後推送」可在提交後繼續同步。
適合誰、要注意什麼¶
README 歸納的適用人羣包括：在 DSH 裏高頻提交的人、不想爲 pull / push / stage 反覆切終端的人、希望提交信息規範但不想每次手寫的人，以及喜歡 GitHub Desktop 式交互但希望面板長在 AI 會話旁的人。
使用前請確認 DSH 版本在 0.2.0 至 0.3.0 之間，且本機 Node 滿足 >=22（Host 側要求）。AI 生成提交信息會把 diff 等內容發到你設置裏的模型服務商；若倉庫敏感，請在設置中選用合適的模型與模式。
DSH 生態是「一切皆插件」；社區目錄（如 SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。本文事實來自插件 README 與 package.json，星標等動態信息以各站點當時展示爲準。
結尾¶
WDX Git 把 Git 留在會話旁邊：一個同步按鈕、默認提交頁與全選改動、可選的 AI 提交信息，並在衝突時留在面板內處理。若要安裝或讀完整 FAQ，見 SkillHub 目錄頁 與 GitHub 倉庫。
