> ## Documentation Index
> Fetch the complete documentation index at: https://docs.42plugin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 管理对话记录

> 使用 CLI 命令管理和导出对话记录

使用 `42plugin chat` 命令管理你与 Claude 的对话记录。

<Info>
  推荐使用快捷方式 `/42plugin-chat` 导出当前对话，详见 [42plugin-chat](/builtin/42plugin-chat)
</Info>

## 查看对话列表

```bash theme={null}
42plugin chat list
```

列出所有已保存的对话记录。

## 查看最近对话

```bash theme={null}
42plugin chat recent
```

快速查看最近的对话记录，默认显示最近 10 条。

## 搜索对话

```bash theme={null}
42plugin chat search "关键词"
```

在对话记录中搜索包含关键词的内容。

## 导入对话

```bash theme={null}
42plugin chat import <path>
```

从文件导入对话记录。支持导入 JSON 格式的 Claude Code 对话文件。

## 管理自动保存

```bash theme={null}
# 查看当前状态
42plugin chat autosave

# 开启自动保存
42plugin chat autosave on

# 关闭自动保存
42plugin chat autosave off
```

<Warning>
  如果你之前使用的是旧版自动保存（基于 hook），升级到新版后请先运行 `42plugin chat autosave` 查看状态，确认已切换到内置自动保存。旧版 hook 配置可安全删除。
</Warning>

## 导出对话记录

### 交互式导出

运行以下命令进入交互式界面：

```bash theme={null}
42plugin chat export
```

按提示选择：

1. **导出范围**：今天 / 本周 / 本月 / 全部 / 自定义日期
2. **项目筛选**：全部项目或指定项目
3. **输出目录**：默认 `./chats`

### 命令行模式

适合脚本调用或快速导出：

```bash theme={null}
# 导出今天的对话
42plugin chat export -d today

# 导出本周的对话到指定目录
42plugin chat export -d week -o ~/my-chats

# 导出指定项目的对话
42plugin chat export -p "my-project" --all

# 导出指定日期范围
42plugin chat export --from 2025-12-01 --to 2025-12-31 --all
```

## 导出文件结构

导出完成后，你会得到两个文件夹：

```
./chats/
├── hi/          # 仅用户输入
│   └── 2025-12-30-a1b2c3d4.md
└── hi+ai/       # 完整对话（含 AI 回复）
    └── 2025-12-30-a1b2c3d4.md
```

### 文件示例

`hi/` 目录下的文件（仅用户输入）：

```markdown theme={null}
# 用户输入记录 2025-12-30

> Session ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
> 项目: my-awesome-project
> 创建时间: 2025-12-30 10:15:30

---

## User [10:15:30]

帮我写一个快速排序算法

---

## User [10:16:45]

加上注释说明

---
```

`hi+ai/` 目录下的文件包含完整对话，包括 Claude 的回复。

## 子命令一览

| 子命令             | 说明     |
| --------------- | ------ |
| `chat list`     | 查看对话列表 |
| `chat recent`   | 查看最近对话 |
| `chat search`   | 搜索对话内容 |
| `chat import`   | 导入对话记录 |
| `chat export`   | 导出对话记录 |
| `chat autosave` | 管理自动保存 |

## 相关功能

<CardGroup cols={2}>
  <Card title="快捷导出" icon="bolt" href="/builtin/42plugin-chat">
    使用 /42plugin-chat 快捷导出当前对话
  </Card>

  <Card title="自动保存" icon="floppy-disk" href="/builtin/autosave">
    自动保存对话记录功能
  </Card>
</CardGroup>