在 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 用户提供了任务进度的实时监控能力。对于需要长时间运行或复杂任务的场景，它能有效缓解等待焦虑，提升开发体验。
