前言¶
在 DeepSeek Harness（DSH）桌面端裏寫代碼、跑智能體會話時，倉庫往往已經掛在宿主註冊的 Workspace 上，但查看提交歷史、對比差異、暫存提交和切分支仍要切到終端或外部 GUI。dsh-git-workspace 把「審查」收進右側欄：歷史、工作區更改、分支入口在同一套界面裏完成，Git 命令由宿主通過 Workspace 與 subprocess 服務執行，瀏覽器側不直接跑 shell。
下面介紹插件定位、能力、安裝步驟和日常使用要點；事實以 GitHub 倉庫 README 與包元數據爲準。
這是什麼¶
dsh-git-workspace（npm 包名 @monster-30cl/dsh-git-workspace，當前版本 0.1.0）是由 monster-30cl 維護的 客戶端 類 DSH 插件。簡介概括爲：面向 DeepSeek Harness Desktop 的 Git 審查、工作區更改與分支管理界面。
插件啓動時只讀取倉庫狀態，不會自動改動工作區。未向會話模型註冊工具，也不會自動拉起對話；僅在用戶點擊「AI 生成提交備註」時，纔會把本次勾選文件的列表與差異發給宿主配置的默認模型。
核心功能¶
統一的「審查」頁¶
右側欄開始頁進入「審查」後，可同時看到提交歷史與工作區更改。提交側支持：
- 搜索框按提交說明過濾；
- 作者下拉按提交作者過濾；
- 日期區間（可只選起始、只選結束或起止都選，按 Git 提交時間，起止日均含當天）與上述條件疊加或分別清空。
點選提交可查看文件列表、前後內容與補丁。代碼區支持 Ctrl + 滾輪縮放文字（也可在設置裏改附加按鍵，默認 Alt）；左右代碼區默認橫向、豎向同步滾動，標題欄按鈕可開關兩個方向的聯動。
工作區更改與提交¶
「代碼提交」區域支持提交、提交併推送、拉取、推送、擱置和回滾；勾選文件決定本次操作範圍。提交或推送成功後，上半區歷史會刷新並保留已有篩選；若提交成功但推送失敗，仍會刷新本地提交記錄。
未跟蹤文件列表默認摺疊，未跟蹤項不能直接勾選提交；點文件右側「＋」加入版本管理後纔會進入「更改」列表並參與提交。回滾尚未提交的新增文件時，只取消版本管理、保留磁盤內容，文件回到未跟蹤列表。
提交、提交併推送或擱置需填寫備註；有上次成功操作的備註時可一鍵回填。備註窗口標題旁的星光圖標可 AI 生成提交備註（基於勾選文件與差異，輸出中文），使用宿主默認模型；生成不會改暫存區或自動提交。關閉窗口、改勾選或改備註會取消進行中的生成請求。
分支¶
會話頭部分支名可切換本地或遠程分支，菜單末尾可打開完整分支頁。完整頁支持選擇 Workspace、刷新分支、新建分支、檢出遠程分支。「刷新」重讀本地記錄；「同步遠端」執行 git fetch --all --prune，更新遠端並清理已刪除的遠端跟蹤記錄，不刪本地分支、不自動合併。
安裝與啓用¶
桌面端安裝 不能 用 dsh plugin --profile desktop 改 Desktop 的保留 profile；應在桌面菜單「桌面插件…」裏填入構建或下載得到的 .tgz 絕對路徑 後執行安裝。
從 GitHub 源碼構建¶
需要 Node.js 22.19 或更高版本（package.json 中 engines.node 爲 >=22.19.0）。
git clone https://github.com/monster-30cl/dsh-git-workspace.git
cd dsh-git-workspace
corepack enable
pnpm install
pnpm run check
pnpm pack
pnpm run check 會先 build 再 verify 面板接線。構建完成後，在「桌面插件…」安裝框填入生成的 monster-30cl-dsh-git-workspace-0.1.0.tgz 的絕對路徑。安裝後啓用「Git 工作區」插件並重啓桌面端。
宿主須已爲會話註冊對應 Workspace；普通目錄可打開界面，但 Git 操作會提示該目錄不是工作樹。
從 Release 安裝¶
每個 v* 標籤會附帶 .tgz。下載後在「桌面插件…」中填入 tarball 絕對路徑（例如 C:\path\to\monster-30cl-dsh-git-workspace-0.1.0.tgz）並安裝。
典型用法¶
- 在右側欄點「審查」，用搜索、作者、日期篩提交，點某次提交看 diff。
- 在「代碼提交」區勾選要納入的文件，填備註或點星光圖標生成備註，再執行提交、推送或擱置等操作。
- 點會話頭部分支名切換分支，或打開完整分支頁做 fetch、新建與檢出遠程分支。
適用場景與注意¶
適合誰： 已在 DSH Desktop 裏用 Workspace 管項目、希望少切終端完成 review 與日常 Git 操作的開發者。
安全與權限： 提交、推送、拉取、擱置、恢復與分支切換會修改共享 Workspace；分支切換前會請求確認。回滾未提交改動或刪除擱置可能造成數據丟失，操作前核對勾選文件。Host 只接受已註冊的 Workspace id，並把路徑限制在該 Workspace 內。插件以當前 DSH 宿主權限執行 Git；安裝前建議閱讀源碼與 MIT License（包內亦含源自 DeepSeek Harness 的 MIT 代碼聲明）。
AI 備註限制： 每次最多分析 60 個文件，長 diff 會截斷，二進制僅提供文件信息；請求最長等待 90 秒，結果需人工覈對。未配置默認模型時會提示原因，仍可手寫備註。
兼容性： 當前構建面向 DeepSeek Harness Desktop 0.2.1-rc.3 的客戶端服務與圖標命名，並在兼容 DSH 環境中驗收。依賴宿主的 Workspace、subprocess、Remote 與右側欄客戶端服務；不保證純 headless 命令行 profile 能顯示客戶端界面。
生態說明： DSH 奉行「一切皆插件」；社區目錄站點 Skillhub 插件頁 爲獨立收錄，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-git-workspace 把提交歷史篩選、diff 閱讀、工作區提交與分支管理收進 Desktop 右側欄，Git 實際執行留在宿主 Workspace 邊界內。需要安裝包或源碼時，可訪問目錄頁 skillhub.cn/plugins/monster-30cl/dsh-git-workspace 與倉庫 github.com/monster-30cl/dsh-git-workspace。
