前言¶
在 DSH 裏改代碼時，工作區往往已經有一堆未提交 diff，但對話界面本身不負責看改動、勾暫存、寫提交說明。常見做法是切到 IDE 或終端跑 git status、git diff，再回到對話繼續——上下文容易斷，也很難在同一會話裏讓 AI 參照「真實暫存區」起草提交信息。
dsh-code-review 是 DSH（DeepSeek Harness）的 Web UI 客戶端插件：在當前對話所屬 Git 倉庫上打開非模態浮動窗口，直接基於未提交狀態做並排審閱、按文件或變更塊暫存與還原，並在窗口內完成提交與推送。下面按定位、能力、安裝與典型用法說明。
這是什麼¶
- 名稱與包名：
@acanzaima/dsh-code-review（倉庫 acanzaima/dsh-code-review，維護者 acanzaima）。 - 分類：客戶端插件（
dsh.client.platform: web，注入對話與設置等 UI 槽位）。 - 一句話：在 DSH Web UI 中，用浮動窗口審閱當前工作區 Git 倉庫的未提交改動，可選 AI 歸類與草擬提交信息。
- 運行前提：本機可用 Git；Node.js ≥ 20.11（資料寫明 DSH 桌面端已內置滿足要求的運行時）。已在 DSH 0.2.2-rc.1 上驗證；
package.json當前版本爲 0.2.2，許可證 MIT，運行時依賴爲 0。
插件以當前 DSH 進程權限操作本機 Git 倉庫，安裝與啓用前請自行查看源碼與許可證，涉密倉庫慎用會向模型發送內容的 AI 功能。
核心功能¶
審閱與 Git 操作¶
- 並排審閱：文件 diff、語法高亮、增刪統計，支持搜索與跳轉上一處 / 下一處變更。
- 選擇提交內容：按文件或分組勾選暫存、取消暫存；右鍵文件或 diff 變更塊可暫存、取消暫存或還原（還原丟棄未暫存改動，需確認且不可撤銷）。
- 提交與推送：填寫提交信息並提交；需要時推送，可配置遠程地址。推送預覽不自動
git fetch，也不強制覆蓋遠端。 - 窗口行爲：多工作區 / 多會話可各開獨立審閱窗口，可拖動、縮放、最小化，不阻塞對話；適配 DSH 淺色 / 深色主題，中英雙語。刷新 DSH 頁面會關閉所有審閱窗口。
可選 AI¶
- AI 歸類（默認關閉）：除按 Git 狀態分組外，可切換「按職能」或「按功能邏輯」整理文件列表；失敗時仍可按 Git 狀態審閱。會向 DSH 模型服務發送項目線索、變更路徑等元數據及少量未跟蹤文本文件摘錄；詳見倉庫內 AI 歸類說明。
- AI 生成提交信息：提交區 sparkles 圖標根據已暫存改動的 diff 與最近提交標題草擬信息，只寫入可編輯框，不自動提交；詳見 AI 生成提交信息說明。
明確不覆蓋的能力¶
提交歷史、分支切換、stash、rebase、衝突解決等需用其他 Git 工具；二進制文件無逐行 diff，部分類型不支持按變更塊操作；變更列表過大時會截斷並禁用全選與提交。
安裝與啓用¶
推薦在 DSH 桌面端「插件」頁從 npm 包安裝，包名爲：
@acanzaima/dsh-code-review
步驟：
- 打開 DSH 桌面端，側欄進入插件。
- 點擊添加插件，在「包名或地址」填入
@acanzaima/dsh-code-review，點擊安裝。 - 安裝後點立即啓用；若已關閉對話框，在已安裝插件中打開開關。
- 回到對話，輸入框工具行出現「打開 Code Review」即成功；若沒有，重啓一次 DSH。
升級：先在插件頁卸載舊版，再安裝新版。跟進源碼或排障時，可向插件頁填入克隆目錄或 Releases 解壓目錄的絕對路徑（含 package.json 的一層）安裝；資料寫明源碼包已含構建好的客戶端文件，無需自行安裝依賴或構建。
典型用法¶
- 在對應 Git 項目的 DSH 對話中，點擊輸入框工具行的 Code Review 圖標（懸停「打開 Code Review」）。
- 左側選文件看 diff，可搜索或跳轉變更。
- 勾選文件或分組加入暫存區；取消勾選僅移出暫存，不改文件內容；列表頂部全選只作用於當前篩選結果。
- 展開底部提交區，填寫提交信息並提交；需要同步遠程時再點「推送」。可用 sparkles 按已暫存改動讓 AI 草擬提交信息，確認或修改後再提交。
窗口內按 ? 查看快捷鍵；Esc 關閉菜單或對話框，審閱窗口用標題欄關閉。多窗口時可用標題欄「最小化」收成帶倉庫名的標題條，點向上箭頭恢復。
適用場景與注意¶
適合：在 DSH 會話內完成「看 diff → 部分暫存 → 提交 / 推送」閉環的開發者；希望減少在終端與對話之間來回切換、又需要真實倉庫狀態（非粘貼 diff）的場景。
注意：
- 插件在本機以 DSH 進程權限執行 Git 與可選 AI 調用；涉密項目建議關閉 AI 歸類，並謹慎使用 AI 草擬提交信息。
- 社區目錄 skillhub 插件頁 與 GitHub 爲獨立信息源；DSH 生態強調「一切皆插件」，該目錄站與 DeepSeek / 幻方無資料所述的官方從屬關係。
- Issue、PR 與開發文檔見倉庫 README 及
docs/。
結尾¶
dsh-code-review 把當前對話工作區的 Git 未提交改動帶進 DSH 界面：真實狀態、並排 diff、細粒度暫存與還原，再到提交與推送，窗口不擋對話。安裝包名 @acanzaima/dsh-code-review；更多說明見 目錄頁 與 GitHub 倉庫。
