🐳 task-progress-bar（dsh-progress-widget）

DeepSeek Harness 任务进度条——你发消息，进度条立刻出现；它干到哪一步、用了多久、还要多久，一眼看清；干完自动告诉你"✅ 已结束"。

一个为 DeepSeek Harness Web 界面设计的小插件：在页面底部以悬浮条实时展示 agent 当前任务的阶段进度、百分比、当前动作、已用时间、预计剩余时间。

✨ 这是什么（30 秒看懂）

你在 DSH 里给 agent 派活时，它经常"闷头干"——你不知道它到哪一步了、还要等多久。这个插件让任务全程可视化：

┌──────────────────────────────────────────────────────┐
│ 🔵 问题修复            [deepseek-harness]   [–]      │
│ ~阶段 2/3 · 实施修复（自动估计）              47%    │
│ ▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░░                         │
│ ⚙ 正在编辑 lib/index.js · 已用 3 分 12 秒 · 预计还需约 4 分钟 │
└──────────────────────────────────────────────────────┘

• 你发消息 → 进度条立刻出现（任务名自动总结成短名：问题修复 / 功能开发 / 方案咨询…）；
• 干活时 → 阶段、步数、已用时间实时跳动，预估剩余时间有逻辑地推算；
• 干完时 → 变绿"✅ 已结束 · 用时 X"，30 秒后自动淡出；
• 多窗口同时干活 → 各自独立跟踪，显示最近活跃任务 + 橙色角标"N 个任务进行中"；
• 完全空闲 → 缩成半透明小灰点，不打扰。

🎯 为什么好用

🚀 安装

# 从 GitHub 安装（推荐）
dsh plugin --profile web add github:uuhihj/task-progress-bar

# 固定版本
dsh plugin --profile web add github:uuhihj/task-progress-bar#v0.1.0

# 或：DSH 设置页 → 插件市场 → 搜索 task-progress-bar 一键安装

本地开发：dsh plugin --profile web add link:<本仓库绝对路径>，改代码后重启 dsh 即生效。

安装后重启 dsh web，页面底部就会出现进度条。

🖥️ 显示状态一览

⚙️ 工作原理

• 自动层（核心）：任务生命周期由 DSH 事件流自动判定——开始 = 用户消息后的 turn/start；进行 = step/start 自动计数；结束 = turn/end（每轮回复完成立即结束）。自动阶段模板按任务类型套用，标题用关键词映射成短名，ETA = 消息复杂度 × 项目基线 × 进展动态修正。
• 上报层（可选增强）：agent 可维护进度文件叠加语义——真实阶段名、精确百分比、当前动作、更准的 ETA。有上报显示真实阶段，无上报纯自动运行。
• 过期防误杀：agent 上报的 running 任务超过 max(2 分钟, 上报 ETA×1.5) 且系统无任何活跃任务时才判残留失效——长步骤任务绝不误杀，忘了标 done 也不会永久卡住。

📦 agent 上报协议（可选）

想让 agent 显示更精确的阶段/ETA，可让它维护进度文件 $DSH_HOME/dsh-progress.json（DSH_HOME 默认 ~/.dsh）：

{
  "task": "任务名",
  "project": "项目名（可选）",
  "stages": ["调研", "方案", "实现", "验证", "收尾"],
  "current": 2,
  "pct": 55,
  "action": "正在编辑 lib/index.js",
  "etaMin": 8,
  "status": "running",
  "startedAt": 1788300000000,
  "updatedAt": 1788300000000
}

agent 行为约定：开工第一步写 running；每阶段更新；任务真正结束标 done（最后一个动作）。

🖱️ 交互

• 按住拖动，位置自动记忆（localStorage），刷新不丢；
• 右上"–"收起为小圆点（显示阶段数/✓/!），点圆点展开；
• 点击与拖动自动区分（位移超过阈值才算拖动）。

🔌 接口

GET /dsh-progress/status → { ok, task, live, activeCount }

📄 License

MIT