hud

hud — Real-Time Task Status HUD

name

hud

description

任务实时状态 HUD（Head-Up Display）：以飞行员 HUD 的方式，在每个任务执行节点实时推送状态更新。HUD 不打断工作流，而是以紧凑的可视化格式呈现进度、资源消耗、风险预警。与 progress-tracking（事后报告式）不同，hud 是主动推送式——持续显示当前状态，让用户始终知道"现在在哪"。

when to activate

用户说以下话时激活：

• "hud"
• "显示进度"
• "实时状态"
• "给我一个仪表盘"
• "显示当前任务状态"
• "autopilot"（自动与 autopilot 技能联动）
• 当执行时间预计超过 5 分钟的任务时自动触发

protocol

HUD 布局规范

标准 HUD 格式（单行/双行）：

┌─────────────────────────────────────────────────────────┐
│ ⬡ [项目名]        ⏱ 12:34    ████████░░░░░░░░  58%   😐  │
│ [当前任务] ──▶ [下一步]                               │
│ ⚠ 风险: [如有]                                         │
└─────────────────────────────────────────────────────────┘

ANSI 彩色 HUD（CLI）：

  ⬡ myproject   12:34   ▓▓▓▓▓▓▓▓░░░░  58%   ⏳ build:✓  test:▓▓
  → Writing index.ts ──▶ Running tests
  ⚠ slow query detected (>2s)

纯文本 HUD（无 ANSI）：

[========----] 58% | myproject | 12:34 | BUILD:OK | TEST:RUN
-> Writing index.ts -> Running tests
[!] slow query detected (>2s)

---

HUD 数据源

HUD 自动读取以下数据：

数据字段	来源	更新频率
项目名	当前工作目录名	静态
耗时	计时器	每节点
进度条	已完成任务/总任务	每节点
当前节点	当前执行步骤名	每节点
下一步	队列中下一个任务	每节点
风险预警	执行过程中检测	实时
情绪指标	错误率/成功率	每节点

---

HUD 更新协议

更新触发点：

1. 任务节点开始 → 显示节点名 + 开始时间
2. 任务节点完成 → 更新进度 + 显示耗时
3. 检测到风险 → 在 HUD 底部追加警告行
4. 任务队列变化（添加/删除）→ 重绘进度条
5. 每 30 秒（无其他事件）→ 发送心跳更新

风险等级与颜色：

• 🟡 WARNING（黄）：可能延迟，但不阻塞
• 🟠 ALERT（橙）：需要关注，可能影响进度
• 🔴 CRITICAL（红）：阻塞性问题，需要人工介入

超时规则：

• 单节点预估时间超过 5 分钟时，显示 ⏳ 并预估剩余时间
• 单节点实际时间超过预估 2 倍时，触发 ALERT
• 连续 3 个节点超时，升级为 CRITICAL 并暂停，等待用户确认

---

HUD 格式化 API

提供以下 HUD 格式化函数（可在任何执行上下文中调用）：

hud_start(project_name, total_steps):

┌────────────────────────────────────────┐
│ ⬡ [project_name]    ⏱ 00:00           │
│ [====--------]   0/[total_steps]       │
│ → 初始化...                             │
└────────────────────────────────────────┘

hud_update(current_step, next_step, progress_pct, elapsed):

┌────────────────────────────────────────┐
│ ⬡ [project_name]    ⏱ [elapsed]       │
│ [██████--------]   60%  [X/Y]          │
│ ✓ [完成步骤]                             │
│ → [当前步骤] ──▶ [下一步]               │
└────────────────────────────────────────┘