前言¶
在 DeepSeek Harness (DSH) 中,智能體對工作區文件進行修改後,查看變更並直接執行 git 操作通常需要切換到外部終端。dsh-git-review 作爲一個客戶端插件,在會話視圖中註冊了一個 Review tab,提供了一個 fenced git workbench。它將文件樹、差異視圖和提交圖與受保護的 git 操作整合在同一界面中,方便查看決策依據並進行操作。
核心功能¶
Review tab 與差異查看¶
插件註冊了 Review tab,用於顯示工作區倉庫與 HEAD 的對比。支持可過濾的文件樹,並在文件和狀態上顯示徽章。差異視圖支持並排、統一和全文件模式,提供代碼摺疊、單詞級高亮和語法高亮。支持在文件名、差異文本和文件內容中進行搜索。支持基於鍵盤的操作:使用 j/k 在文件間移動,/ 聚焦搜索。
提交圖視圖¶
提供提交圖視圖,可以查看按提交的文件和差異,顯示錯行 gutter,並支持按文件歷史查看。允許從歷史記錄中讀取任何文件版本。
受保護的 Git 操作¶
針對危險操作提供保護機制。支持暫存、取消暫存和丟棄文件/塊,提交、提交併推送、推送。支持分支管理操作:創建、切換、重命名、刪除、合併、跟蹤遠程,以及 fetch/pull。支持歷史操作:重置、變基、變更爲、cherry-pick。支持輕量級標籤(創建、刪除、推送)和 stash。支持合併衝突解決。
註釋與預覽¶
支持在 diff 的任意行添加註釋,並將其放入編輯器草稿中。支持文件預覽,包括 Markdown、HTML、PDF。支持圖片差異查看,提供 2-up、onion skin 和 difference blend 模式。
設置與同步¶
插件支持設置同步。
安裝與啓用¶
安裝插件:
dsh plugin --profile web add dsh-git-review
安裝後需要重啓或刷新 DSH 進程以生效。
使用場景與限制¶
適用環境¶
需要 DeepSeek Harness 版本在 0.1.2-rc.1 到 0.2.0-rc.1 之間。需要在主機 PATH 環境中安裝 git。如果在非 git 倉庫目錄下打開,插件會提供文件瀏覽功能,並支持一鍵 git init。
安全與鎖定¶
危險操作需要顯式確認,破壞性操作需要雙重確認。代理運行時會對操作進行鎖定。
性能限制¶
插件在客戶端運行,存在以下限制:
* 單文件差異行數限制爲 20k 行。
* 單文件差異大小限制爲 2MB。
* 提交圖頁面加載限制爲 500 次。
* 流式字節傳輸限制爲 8MB。
總結¶
dsh-git-review 爲 DSH 提供了一個集成的代碼審查和 Git 工作臺。它通過 Review tab 將變更展示、提交圖和歷史查看與受保護的 Git 操作結合,適合需要在 DSH 界面內直接管理 Git 狀態和審查代碼變更的場景。
- 插件目錄:https://www.skillhub.cn/plugins/HaoyueQin/dsh-git-review
- GitHub 倉庫:https://github.com/HaoyueQin/dsh-git-review