AgentStatus
表示智能体的运行和等待状态。中文惯用名：智能体状态。
稳定本期新增已接入
元信息
| 字段 | 值 |
|---|---|
| 规范 ID | component.agent-status |
| 名称 | AgentStatus |
| 二级分类 | AI 与会话（ai-chat） |
| 用途 | 表示智能体的运行和等待状态 |
| 描述 | 中文惯用名：智能体状态。 |
预览
静态结构：flex 行 = 状态图标（running → loader-circle 旋转 text-info；waiting → clock text-warning；done → circle-check text-success；error → circle-x text-destructive）+ 文本 + 可选「已用时 Xs」。
DSL 结构
{
"type": "AgentStatus",
"props": {
"status": "running",
"text": "正在执行数据分析",
"elapsed": 12
}
}何时用
何时使用
- 表示智能体的运行和等待状态：执行过程行（含耗时）。
何时不用
- 业务状态（审核 / 发布）：使用通用分类 Status。
变体
| 变体 | 视觉形态 | 适用场景 |
|---|---|---|
| running | 旋转图标 | 执行中 |
| waiting | 时钟图标 | 排队 / 等待输入 |
| done / error | 对勾 / 叉 | 完成 / 失败 |
API 属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
status | `'running' | 'waiting' | 'done' |
text | string | — | 状态文本 |
elapsed | number | — | 耗时（秒） |
className / style | string / CSSProperties | — | 通用：根节点 class 合并 / 内联样式 |
使用规范
- running 必须有终态流转（done / error），不长期悬挂。
正例
- ✓ 任务面板：AgentStatus 实时展示「检索文档 · 已用时 3s」。
反例
- ✕ 用 AgentStatus 表达订单状态（应使用 Status）。
Design Token 映射
不适用：组件 tokenRefs 为空：样式 Token 数据尚未接入，三层映射（Primitive → Semantic → Component）待样式 Token 接入后回填。