在 DeepSeek Harness (DSH) 中,Agent 執行任務的過程往往是“黑盒”,用戶難以掌握具體的階段、耗時與剩餘時間。DeepSeek Harness 任務進度條插件旨在解決這一痛點,通過一個獨立的懸浮窗口,實時展示任務階段、百分比、當前動作、已用時間及預計剩餘時間。
插件概述¶
該插件由 uuhihj 維護,是一款開源工具。它主要解決 Agent 任務執行過程中的可視化問題,讓用戶能夠直觀地監控任務生命週期。
核心功能¶
-
全自動驅動任務生命週期
插件通過 DSH 事件流自動判定任務的開始、進行與結束,不依賴 Agent 的主動上報,裝上即用。 -
有邏輯的 ETA 估算
插件具備合理的預計剩餘時間(ETA)計算邏輯,能根據任務進展動態修正估算值。 -
智能階段模板
插件支持根據任務類型自動生成階段描述。 -
智能任務名總結
能夠自動將用戶派發的任務消息總結爲短名,便於閱讀。 -
防誤殺過期任務
內置任務過期判定邏輯,避免長步驟任務被誤判失效。 -
零侵入獨立 DOM 懸浮窗
在頁面底部顯示,不注入任何 DSH 原生 UI 槽位,不影響對話界面。 -
支持多任務併發與位置記憶
能夠同時跟蹤多個併發任務,並記錄窗口位置,刷新後不丟失。
安裝與啓用¶
使用以下命令從 GitHub 安裝插件:
dsh plugin --profile web add github:uuhihj/task-progress-bar
安裝後需要重啓 DSH Web 進程,頁面底部纔會出現進度條。
典型用法¶
- 任務派發後:進度條會立即出現在頁面底部,顯示任務名與初始狀態。
- Agent 上報:如果 Agent 上報了進度信息(如
dsh-progress),界面將顯示更精確的階段和 ETA。 - 任務完成:任務完成後,界面會自動顯示綠色’✅ 已結束’狀態,並在 30 秒後自動淡出。
- 空閒狀態:當所有任務完成進入空閒時,進度條會自動縮成半透明小灰點,點擊可展開查看詳情。
注意事項¶
- 插件採用 MIT 許可證。
- 需要運行環境 Node.js 版本 >= 22.19.0。
- 任務過期判定邏輯爲
max(2 分鐘, 上報 ETA×1.5)。 - 完全空閒時顯示小灰點,點擊可展開。
總結¶
該插件通過零侵入的方式,爲 DSH 用戶提供了任務進度的實時監控能力。對於需要長時間運行或複雜任務的場景,它能有效緩解等待焦慮,提升開發體驗。