---
url: /kimi-cli/zh/guides/sessions.md
---
# 会话与上下文

Kimi Code CLI 会自动保存你的对话历史，方便你随时继续之前的工作。

## 会话续接

每次启动 Kimi Code CLI 时，都会创建一个新的会话。在运行过程中，你也可以输入 `/new` 命令随时创建并切换到一个新会话，无需退出程序。

如果你想继续之前的对话，有几种方式：

**继续最近的会话**

使用 `--continue` 参数可以继续当前工作目录下最近的会话：

```sh
kimi --continue
```

**交互式选择会话**

使用 `--session`（或 `--resume`、`-S`、`-r`）不带参数可以打开交互式会话选择器，用方向键选择要恢复的会话：

```sh
kimi --session
```

> 交互式选择器仅在 Shell 模式下可用。

**恢复指定会话**

使用 `--session`（或 `--resume`）加上会话 ID 可以恢复指定的会话：

```sh
kimi -r abc123
```

如果指定的会话 ID 不存在，会自动创建一个新会话。

**在运行中切换会话**

输入 `/sessions`（或 `/resume`）可以查看当前工作目录的所有会话列表，使用方向键选择要切换的会话：

```
/sessions
```

列表会显示每个会话的标题和最后更新时间，帮助你找到想要继续的对话。按 `Ctrl-A` 可在 「仅当前目录」 和 「所有目录」 之间切换范围，方便跨项目查找会话。使用 `/title <text>` 可以为会话设置一个自定义标题，方便后续查找。

**退出时的续接提示**

当会话退出时（包括正常退出、`Ctrl-C` 中断、`/undo`、`/fork`、`/sessions` 切换等场景），Kimi Code CLI 会自动打印一条续接命令提示：

```
To resume this session: kimi -r <session-id>
```

你可以直接复制这条命令，下次在终端中运行即可快速恢复该会话。空会话不会显示此提示。

**启动回放**

当你继续一个已有会话时，Kimi Code CLI 会回放之前的对话历史，让你快速了解上下文。回放过程中会显示之前的消息和 AI 的回复。

## 会话状态持久化

除了对话历史，Kimi Code CLI 还会自动保存和恢复会话的运行状态。当你恢复一个会话时，以下状态会自动还原：

* **审批决策**：YOLO 和 AFK 模式的开关状态、通过 "本会话允许" 批准过的操作类型
* **Plan 模式**：Plan 模式的开关状态
* **子 Agent 实例**：通过 `Agent` 工具在会话中创建的子 Agent 实例状态和上下文历史
* **额外目录**：通过 `--add-dir` 或 `/add-dir` 添加的工作区目录

这意味着你不需要在每次恢复会话时重新配置这些设置。例如，如果你在上次会话中批准了某类 Shell 命令的自动执行，恢复会话后这些批准仍然有效。

## 导出与导入

Kimi Code CLI 支持将会话上下文导出为文件，或从外部文件和其他会话导入上下文。

**导出会话**

输入 `/export` 可以将当前会话的完整对话历史导出为 Markdown 文件：

```
/export
```

导出文件包含会话元数据、对话概览和按轮次组织的完整对话记录。你也可以指定输出路径：

```
/export ~/exports/my-session.md
```

**导入上下文**

输入 `/import` 可以从文件或其他会话导入上下文。导入的内容会作为参考信息附加到当前会话中：

```
/import ./previous-session-export.md
/import abc12345
```

支持导入常见的文本格式文件（Markdown、代码、配置文件等）。你也可以传入一个会话 ID，从该会话导入完整的对话历史。

::: tip 提示
导出文件可能包含敏感信息（如代码片段、文件路径等），分享前请注意检查。
:::

## 清空与压缩

随着对话的进行，上下文会越来越长。Kimi Code CLI 会在需要的时候自动对上下文进行压缩，确保对话能够继续。

你也可以使用斜杠命令手动管理上下文：

**清空上下文**

输入 `/clear` 可以清空当前会话的所有上下文，重新开始对话：

```
/clear
```

清空后，AI 会忘记之前的所有对话内容。通常你不需要使用这个命令，对于新任务，开启新的会话会是更好的选择。

**压缩上下文**

输入 `/compact` 可以让 AI 总结当前的对话，并用总结替换原有的上下文：

```
/compact
```

你也可以在命令后附带自定义指引，告诉 AI 在压缩时优先保留哪些内容：

```
/compact 保留数据库相关的讨论
```

压缩会保留关键信息，同时减少 token 消耗。这在对话很长但你还想保留一些上下文时很有用。

::: tip 提示
底部状态栏会显示当前的上下文使用率和 Token 数量（如 `context: 42.0% (4.2k/10.0k)`），帮助你了解何时需要清空或压缩。
:::

::: tip 提示
`/clear` 和 `/reset` 会清空对话上下文，但不会重置会话状态（如审批决策、动态子 Agent 和额外目录）。如需完全重新开始，建议创建一个新会话。
:::