51 lines
1.7 KiB
Markdown
51 lines
1.7 KiB
Markdown
# 324 CommandHistory · 命令历史
|
|
|
|
## 用途
|
|
|
|
按时间倒序列出执行过的命令，可搜索，并通过回调重新运行。
|
|
|
|
## 最小示例
|
|
|
|
```go
|
|
history := []mujica.HistoryEntry{{Command: "git status"}, {Command: "go test ./...", ExitCode: 1}}
|
|
var state mujica.CommandHistoryState
|
|
view := func(c *ui.Context) {
|
|
mujica.Use(c, mujica.Settings{})
|
|
r := mujica.CommandHistory(c, history, &state, mujica.CommandHistoryOptions{})
|
|
r.Element.Height(240)
|
|
if r.Replayed != nil {
|
|
fmt.Println("run", r.Replayed.Command)
|
|
}
|
|
}
|
|
ui.Render(view, 400, 300, 1)
|
|
```
|
|
|
|
## 参数
|
|
|
|
`func CommandHistory(c *ui.Context, entries []HistoryEntry, s *CommandHistoryState, opts CommandHistoryOptions) CommandHistoryResult`。列表虚拟化，筛选只在条目数或查询变化时重算。
|
|
|
|
| 字段 | 类型 | 默认值 | 含义 |
|
|
| --- | --- | --- | --- |
|
|
| `HistoryEntry.Command` | `string` | 必填 | 命令文字。 |
|
|
| `HistoryEntry.Time` | `time.Time` | 零值不显示 | 执行时间。 |
|
|
| `HistoryEntry.ExitCode` | `int` | 0 | 非零时显示“退出码 n”。 |
|
|
| `CommandHistoryState.Query` | `string` | "" | 搜索文字，不区分大小写。 |
|
|
| `Disabled` | `bool` | false | 不能搜索与重放。 |
|
|
|
|
## 状态
|
|
|
|
默认、选中（Selection 背景与菱形标记）、失败命令（Danger 退出码）、无历史、无匹配、禁用。
|
|
|
|
## 事件
|
|
|
|
`Replayed`：要重新运行的条目，没有则为 nil。
|
|
|
|
## 键盘操作
|
|
|
|
- Tab 依次到达搜索框与列表；↑/↓、Home/End 选择；输入字母按命令定位。
|
|
- Enter 或双击：重放当前条目；每行的重放按钮可用 Tab 到达。
|
|
|
|
## 限制
|
|
|
|
- 只追加或整体替换 `entries` 会被识别；原地修改中间条目后请传入新切片。
|