前言¶
在使用 DeepSeek Harness 的 Web 界面（dsh web）時，開發者通常需要在瀏覽器中直觀地查看當前工作目錄的 Git 狀態，並執行提交操作。現有的原生集成往往無法滿足這種細緻的集成需求。dsh-git 插件通過在側邊欄底部添加操作區，解決了在 Web 界面中管理 Git 倉庫狀態的問題。
核心功能¶
插件提供了會話感知的 Git 狀態監控和提交能力。
會話感知狀態¶
狀態顯示與 DeepSeek Harness Web 界面當前打開的會話項目目錄綁定，確保顯示的內容與當前上下文一致。
工作樹詳情¶
面板展示當前分支、上游分支、領先與落後計數、變更文件列表以及插入和刪除的行數統計。
提交與推送¶
提供三個操作按鈕：
* Commit：使用提供的消息提交變更。
* Commit & push：提交變更並推送到遠程。
* Push：僅推送本地已有的提交。
AI 生成提交信息¶
在“Commit”操作中留空提交信息並確認，插件會向當前會話的代理請求生成一條簡潔的提交說明，用於描述當前工作區的變更。
安全刷新¶
在刷新頁面時，插件會保持最後一次準備好的快照可見，並在活躍項目變更時丟棄正在進行的讀取操作，避免狀態混亂。
安裝與啓用¶
通過 DeepSeek Harness 的插件命令進行安裝。
dsh plugin --profile web add @necokeine/dsh-git
安裝後，重啓 dsh web 並刷新頁面即可生效。如需移除，執行：
dsh plugin --profile web remove @necokeine/dsh-git
此外，也可以通過本地路徑或 Git 引用安裝：
dsh plugin --profile web add ./path/to/dsh-git
dsh plugin --profile web add github:necokeine/dsh-git#<sha>
使用示例¶
- 在
dsh web中打開一個擁有項目目錄的會話。 - 側邊欄底部會出現 Git 操作區，顯示當前分支和變更文件。
- 若需提交變更，在提交信息欄留空，點擊 Commit。系統會調用當前會話代理生成提交信息並執行。
注意事項¶
- 會話依賴：只有當前會話擁有項目目錄時，Git 狀態纔會顯示。
- 權限控制：提交和推送操作通過當前會話代理執行，遵循該會話的權限和認證環境。
- 統計範圍：二進制文件和未跟蹤文件不計入行數統計。
- 推送限制：若分支未配置上游，Push 按鈕將保持禁用狀態，直到配置 upstream。
結語¶
該插件通過 Web 界面擴展了 Git 管理能力，適合習慣在瀏覽器中操作 DSH 的開發者。更多細節和源碼，可訪問項目主頁查看。
