在 DeepSeek Harness(DSH)中,當會話和代理在後臺運行時,追蹤它們的狀態(進行中、已完成、等待審批)通常需要頻繁切換標籤頁或查看日誌。dsh-ui-progress 插件提供了一種集中式視圖來管理這些狀態。
這是一個由 sdynasty 維護的插件,爲 DSH 提供跨工作空間的會話進度看板。它將狀態管理從分散的會話視圖中提取出來,通過側邊欄入口和儀表板視圖,提供一種直觀的方式來監控會話生命週期。
核心功能¶
- 側邊欄入口:在側邊欄新增一個“進度看板”入口。
- 三色角標:根據會話狀態顯示不同顏色的角標(藍色:僅有運行中;綠色:有已完成未查看;橙色:有等待處理的會話)。
- 分欄視圖:點擊入口後,看板分爲“全部”、“進行中”、“已完成”三個分欄。
- 工作空間篩選:提供工作空間篩選器,用於過濾所有分欄中的會話。
- 實時狀態:顯示工作空間標籤、運行中的子代理數以及實時的運行時長。
- 快速跳轉:點擊卡片可直接打開對應的會話。
安裝與啓用¶
使用命令行工具安裝插件:
dsh plugin --profile desktop add dsh-ui-progress
安裝後,刷新 Web 界面,側邊欄將出現“進度看板”圖標。
典型用法¶
- 打開側邊欄,觀察“進度看板”圖標的角標顏色,判斷當前有哪些狀態的任務。
- 點擊圖標打開看板,在“進行中”分欄中查看正在運行或等待審批的會話。
- 在“已完成”分欄中查看已跑完但尚未查看的會話(綠色標記),或查看歷史完成記錄。
- 使用工作空間篩選器,定位特定工作空間下的會話。
注意事項¶
- 當前限制:卡片上暫無 todo 或目標進度條。這些數據是會話級的,需要宿主新增
SessionProjectionMap成員才能支持。 - 歷史記錄:完成歷史保存在本機的
localStorage中,不隨賬戶跨設備同步。在客戶端未打開期間完成的會話,會在下次啓動時按“未查看”補記。 - 等待狀態:除了
approval/question/plan-review之外的等待類型,統一顯示爲“等待處理”。 - 外部依賴:插件的運行僅依賴宿主基線模塊(
react、react/jsx-runtime、@deepseek-ai/dsh-client-ui-primitives)。
此插件通過提供集中式狀態概覽來增強 DSH 的會話管理,適合需要高效監控多個並行任務的開發者。更多詳情可參考:GitHub 倉庫。