dsh-git-graph：DeepSeek Harness 的 Git 視圖插件

前言¶

DeepSeek Harness (DSH) 的核心設計理念是插件化，允許開發者將各種能力注入到工作流中。在代碼開發場景下，開發者常需要在對話上下文中直接查看倉庫狀態、操作分支或查看差異。dsh-git-graph 旨在解決這一需求，它通過提供一個 Git 專用面板，將 Git 的核心操作（狀態、分支、差異、歷史）集成到 DSH 的 Web UI 中，而非僅僅依賴命令行或外部工具。

插件信息¶

• 名稱：dsh-git-graph
• 簡介：DeepSeek Harness 集成 Git 視圖的插件。
• 所有者：enoughpower
• 分類：Git, Web UI
• 許可證：MIT

安裝與啓用¶

該插件爲 bundle 插件，安裝後宿主層（API）與瀏覽器層（UI）會自動激活。使用以下命令進行安裝：

# 本地目錄
dsh plugin --profile web add /path/to/dsh-git-graph

# 或已發佈的 npm 包
dsh plugin --profile web add dsh-git-graph

核心功能¶

插件提供了對 Git 倉庫的全方位視圖支持，主要包括：

• 工作區狀態：查看當前分支、已暫存、未暫存及未跟蹤文件，並標註狀態碼。
• 分支管理：支持本地/遠程分支的列出、切換、新建、刪除、重命名與合併。
• 差異與提交：查看工作區與暫存區的差異，支持文件暫存、取消暫存、丟棄修改、物理刪除以及提交和修正提交。
• 歷史與溯源：提供提交日誌、帶父提交的提交圖、單文件歷史、逐行溯源以及查看提交詳情與單文件差異。
• 遠程與標籤：支持推送、拉取、抓取遠端，查看遠程列表與標籤列表。

注：爲了防止超大差異凍結傳輸與前端渲染，差異內容會被截斷至 2 MiB。

使用步驟¶

安裝並啓用插件後，按照以下步驟在會話中使用：

1. 裝好插件並在會話內打開一個工作區（即倉庫目錄）。
2. 會話區域會出現 Git 頁籤（位於對話軌跡右側），點擊進入 Git 面板。
3. 在面板內操作：
   • 頂部爲分支欄與提交圖，用於查看整體狀態。
   • 選中一個提交可查看詳情（變更文件 / 差異）。
   • 選中工作區文件可執行暫存、提交或丟棄操作。
4. 面板會自動綁定當前會話的工作目錄。

兼容性與注意事項¶

• 兼容性要求：
  • DSH 宿主版本：>= 0.1.0-rc.5
  • Node.js：>= 20
  • Git：>= 2.28
• 安全限制：所有 /git 操作都限定在請求的 path 目錄內執行，不引入任意 Shell（通過 execFile 參數數組調用），請求體上限 1MiB，Git 輸出緩衝 64MiB。
• 當前功能狀態：文件瀏覽與編輯功能暫時停用，當前版本專注於 Git 專用操作。

結語¶

dsh-git-graph 爲 DSH 用戶在瀏覽器端提供了一套完整的 Git 工作流工具。它通過半註冊 JSON API 和瀏覽器 UI 的方式，將 Git 操作嵌入到對話環境中。如需更多信息或查看源碼，可訪問插件目錄或 GitHub 倉庫。

• 插件目錄頁
• GitHub 倉庫