52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
# 265 AgentStepList 执行步骤列表
|
||
|
||
## 用途
|
||
|
||
以时间线显示 Agent 的执行步骤：当前步加框标出，步骤可展开详情，失败步提供重试。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
steps := []mujica.AgentStep{
|
||
{ID: "read", Title: "Read the guest list", State: mujica.AgentDone, Duration: time.Second},
|
||
{ID: "seat", Title: "Assign the seats", State: mujica.AgentFailed, Detail: "Table 4 is full."},
|
||
{ID: "send", Title: "Send invitations", State: mujica.AgentPending},
|
||
}
|
||
view := func(c *ui.Context) {
|
||
mujica.Use(c, mujica.Settings{})
|
||
if r := mujica.AgentStepList(c, steps, mujica.AgentStepListOptions{}); r.Retry != "" {
|
||
fmt.Println("retry", r.Retry)
|
||
}
|
||
}
|
||
ui.Render(view, 400, 300, 1)
|
||
```
|
||
|
||
签名：`func AgentStepList(c *ui.Context, steps []AgentStep, opts AgentStepListOptions) AgentStepListResult`。步骤 `ID` 为空或重复、`Title` 为空时 panic。
|
||
|
||
## 参数
|
||
|
||
| 字段 | 类型 | 默认值 | 含义 |
|
||
| --- | --- | --- | --- |
|
||
| `Disabled` | `bool` | `false` | 禁止展开与重试。 |
|
||
| `Still` | `bool` | `false` | 停止执行中动画；系统减少动画时也自动静止。 |
|
||
|
||
## 状态
|
||
|
||
- `AgentStep` 字段：`ID`、`Title`、`Detail`、`State`、`Duration`。
|
||
- `AgentState`：`AgentPending`、`AgentPlanning`、`AgentRunning`、`AgentWaiting`、`AgentDone`、`AgentFailed`、`AgentSkipped`，越界 panic。状态同时由图标形状和文字表达，不只靠颜色。
|
||
- 当前步是第一个执行中、等待或规划中的步骤，用选中底色、边框和“当前”文字标出。
|
||
- 失败步下方显示“重试”。
|
||
|
||
## 事件
|
||
|
||
- `Toggled`：本帧展开或折叠的步骤 ID。
|
||
- `Retry`：本帧请求重试的步骤 ID。
|
||
|
||
## 键盘操作
|
||
|
||
- Tab 进入列表；↑ ↓ 在步骤与重试按钮间移动；Enter / Space 展开详情或重试。
|
||
|
||
## 限制
|
||
|
||
- 步骤数量较少时使用；列表不虚拟化。
|