[ux][dashboard] Agent IM 工作台：左侧 Agent 列表 + 右侧对话窗口

[s2agi]

背景

当前 Dashboard 的 node / agents 相关视图更偏「状态面板」：看在线状态、server、runtime、任务、telemetry 等。随着 Agent Network 里的 agent 数量增加，用户更自然的心智会接近 IM / 协作软件：

• 左侧是可滚动的 Agent / 群组 / channel 列表
• 右侧是与选中 Agent 的对话窗口
• 可以像微信 / 飞书 / Slack 一样快速切换 agent、查看上下文、发任务、看回复

这会把 Agent Network 从「运维式 dashboard」往「多 Agent 协作工作台」推进。

目标

规划一个长期 Dashboard UX 方向：Agent IM workspace。

核心形态：

┌──────────────────────────────┐
│ Left: Agent list / filters    │ Right: Conversation / task thread
│                              │
│  搜索 agent                   │  当前选中 agent: 通信测试牛
│  按 runtime / status 过滤      │  ─────────────────────────
│  ─────────────────────        │  message / task / reply timeline
│  通信龙        idle            │  dispatch box
│  通信牛        working         │  attachments / artifacts
│  通信评审牛    idle            │  task status / retry / reassign
│  通信测试牛    idle   ←        │
│  通信文档牛    idle            │
│  ... scroll ...               │
└──────────────────────────────┘

Scope

Phase 1 — Read-only IM layout

• 左侧可滚动 Agent list
• 支持搜索、runtime 过滤、status 过滤、network 过滤
• 右侧显示选中 agent 的 conversation timeline：
  • tasks sent to agent
  • replies / completions
  • status updates
  • recent output snippets
• 不改变 server 写接口，先读现有 /api/status / /api/tasks / inbox/task_events 数据

Phase 2 — Dispatch box

• 右侧底部支持直接给选中 agent 发 task/message
• 支持 priority、requires_response、parent_task_id/thread context
• 发完后 timeline 立即 append optimistic item，后续按 server 状态更新

Phase 3 — Group / channel mode

• 左侧增加 group/channel：
  • Codex 牛群
  • Claude 马群
  • 文档组 / 测试组 / 评审组
  • project / network 分组
• 支持 broadcast / multi-select dispatch

Phase 4 — Workflow UX

• task retry / cancel / reassign
• agent handoff
• artifacts preview
• per-agent capability / quota / runtime health chip
• unread count / mention / notification

设计原则

• 不替代现有 operational dashboard；而是新增一个协作工作台入口。
• 左侧 list 必须虚拟滚动，避免 agent 数量上来后卡顿。
• 右侧 timeline 必须分页 / windowed load，不能一次拉全量历史。
• 与 [architecture] 评估 Agent Network 性能边界：节点数、任务量、历史记录与 Dashboard 卡顿阈值 #161 性能边界评估联动，先明确 nodes/tasks/events 到多少量级会卡。
• 与 [bug] Dashboard 的 working 状态显示数一直不对 #160 / 🔴 P0 Dashboard Servers 面板数据完全不正确 (Vincent 5560) #157 freshness/status contract 对齐，Agent list 的 online/offline/working 不能各组件各算一套。

依赖

• [architecture] 评估 Agent Network 性能边界：节点数、任务量、历史记录与 Dashboard 卡顿阈值 #161 架构性能边界评估：决定 list virtualization / timeline pagination 的阈值。
• [bug] Dashboard 的 working 状态显示数一直不对 #160 working 数显示错误：先把 status count / freshness 逻辑修准。
• 🔴 P0 Dashboard Servers 面板数据完全不正确 (Vincent 5560) #157 Servers 面板数据正确性：保证 dashboard 数据源可信。
• 后续 token/quota telemetry：Agent list 上展示 runtime quota / fallback readiness。

Non-goals

• 不在第一版做完整 Slack/飞书级群聊。
• 不在第一版重构 commhub 消息协议。
• 不在第一版支持无限历史全文搜索。
• 不直接影响 CLI / agent-node runtime。

验收标准

• 用户可以在 Dashboard 左侧快速找到某个 agent。
• 点击 agent 后，右侧能看到该 agent 最近 task / reply / status timeline。
• Agent 数量达到 100+ 时，左侧滚动不卡。
• Timeline 记录达到 1k+ 时，右侧不会一次性拉全量导致卡顿。
• 发 task/message 的交互不比 CLI 更难用。

建议产物

1. UX wireframe / screenshot mock
2. Dashboard route proposal，例如 /agents-chat 或 /workspace
3. API contract review：现有 endpoint 是否够用，缺什么
4. Phase 1 implementation issue

Author-Agent: 通信牛
Helpers: Vincent (IM-style Agent workspace request)