前言¶
在使用 DeepSeek Harness (DSH) 的 Work 窗口進行開發時，開發者往往需要頻繁切換窗口來確認當前的項目名稱、分支以及變更狀態。omdsh-status 插件將項目名稱和 Git 狀態直接嵌入到對話頭部，位於 Session log 導出按鈕的左側，讓這些信息一目瞭然。
插件定位¶
- 插件名: omdsh-status
- 維護者: omdsh-plugins
- 分類: Insight
- 定位: 在 DSH Work 窗口對話頭部顯示當前項目及 Git 狀態。
核心功能¶
- 對話頭部狀態顯示：在對話頭部顯示項目名稱和 Git 狀態。
- 詳細變更計數：顯示當前分支、ahead/behind、staged、modified、untracked 和 conflicts 的計數。
- API 接口：提供
GET /omdsh-status/status接口。 - 無配置需求：無需設置命名空間，自動讀取工作目錄狀態。
安裝與啓用¶
使用官方插件中心安裝：
npx @omdsh-plugins/omdsh-plughub add omdsh-status
該插件採用 MIT 許可證。
典型用法¶
- 有內容的會話：在對話頭部左側顯示，格式如
omdsh-plugins ⎇ main ↑1 +2 ~3。 - 空白會話：當會話尚未開始時，在框架的浮動層中顯示狀態。
- 非 Git 倉庫：如果當前目錄不在 Git 倉庫中，僅顯示項目名稱，並通過 tooltip 提示。
適用場景與限制¶
- Chat 模式：當使用 Chat 模式（如
basemode+chatmode）時，該插件不會顯示狀態，因爲 Chat 模式下會話不屬於特定的項目目錄。 - Code 模式：Code 模式將對話欄替換爲終端，插件會自動隱藏狀態顯示。
- 安全機制：Git 狀態的解析在宿主機運行，只返回計數數字，不會向瀏覽器發送路徑列表、diff 或分支圖。
- 輪詢策略：插件使用高效的輪詢機制，緩存結果 2 秒，可見頁面每 4 秒重新請求一次。
結語¶
omdsh-status 通過在頭部提供直觀的項目和 Git 狀態，減少了上下文切換的干擾。更多細節可查閱 插件目錄 或 GitHub。
