# 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` 会被识别；原地修改中间条目后请传入新切片。