DeepSeek Harness (DSH) 提供基於 Web 的編輯器環境。在開發流程中，快速確認當前分支、變更數量和文件狀態往往需要切換到終端執行 git status。dsh-plugin-git-status 將這些信息直接集成到編輯器工具行，並提供了一個結構化的 git_status 工具。
插件介紹¶
該插件由 jdz321 維護，是一個針對 DeepSeek Harness 的工具插件。它不創建、修改或刪除任何文件，僅用於展示和檢索 Git 狀態。
核心功能¶
- 編輯器工具行狀態芯片：在模型選擇器左側顯示當前分支名、工作區潔淨狀態（潔淨/髒）以及一個手動刷新按鈕。
- 可展開的變更列表：當工作區有變更時，點擊變更計數會展開分組文件列表。列表按衝突、已暫存、未暫存、未跟蹤分類，並顯示 porcelain 狀態代碼和重命名原路徑。
- 自動刷新：默認每 30 秒自動刷新一次狀態。
git_status模型工具：在工具管道中調用，返回結構化 JSON 數據，包含分支、提交、文件列表等。- 只讀操作：僅讀取 Git 狀態，不涉及文件系統寫入。
安裝與啓用¶
通過 DSH CLI 安裝：
dsh plugin --profile <name> add dsh-plugin-git-status
安裝後需要重啓 DSH 進程，並在瀏覽器中硬刷新頁面以加載插件。
配置與使用¶
配置刷新間隔¶
刷新間隔可以通過瀏覽器界面或配置文件修改。
- 瀏覽器界面：打開瀏覽器設置 -> 插件 -> 編輯 Git status 卡片，修改
refreshIntervalMs。 - 配置文件：在
cordis.patch.yml中添加config塊：
- id: dsh-plugin-git-status
name: dsh-plugin-git-status
config:
refreshIntervalMs: 60000
將 refreshIntervalMs 設置爲 0 可完全禁用自動刷新。
調用模型工具¶
在工具管道中可以直接調用 git_status 模型工具。該工具接受一個可選的 cwd 參數，若不提供則默認檢查當前會話工作區。
注意事項¶
- 只讀限制：插件爲只讀模式，不提供內聯文件操作。
- 會話作用域：面板僅在 Git 倉庫工作區會話中顯示，非倉庫目錄不會顯示。
- 自動刷新暫停：當瀏覽器標籤頁隱藏時，自動刷新會暫停，標籤頁恢復可見時會立即刷新一次。
- 路徑處理：正確處理包含連續空格的路徑。
總結¶
dsh-plugin-git-status 爲 DSH 提供了可視化的 Git 狀態面板和程序化的 JSON 接口，適合需要頻繁監控代碼變更或在智能體工具鏈中獲取 Git 信息的場景。
