Gemini CLI 的会话管理功能让你随时恢复上次未完成的工作：gemini -r 一键续上最近对话；/resume 打开可搜索的历史浏览器；/rewind 精准撤销错误操作，还能选择只回滚对话、只还原文件或两者一起回滚。本页是完整的会话管理操作指南。

会话管理：恢复、浏览历史与撤销

掌握 Gemini CLI 的会话管理功能，让你可以在任务间自由切换，随时续上未完成的工作，或从错误中精准恢复。

前置条件

• Gemini CLI 已安装并完成认证，参见 安装指南
• 至少有一个活跃或历史会话

恢复上次对话

最快方式：--resume 标志

切换任务后想快速续上最近的工作，用 -r 标志：

gemini -r

这会恢复聊天历史和内存上下文，你可以直接说"继续下一步"，不需要重新解释背景。

浏览所有历史会话

想找前天某个具体的对话，用 /resume 命令：

/resume

这会打开可搜索的会话列表，每条记录显示：

• 时间戳（如"2 小时前"）
• 第一条用户消息（帮你识别话题）
• 对话回合数

上下方向键选中会话，按 Enter 加载。

管理会话列表

用久了会积累大量历史，定期清理让你更容易找到想要的会话。

删除不需要的会话

在 /resume 浏览器中，选中一条历史会话，按 x 永久删除该对话。

也可以用命令行管理：

# 列出所有会话及其 ID
gemini --list-sessions

# 按 ID 或序号删除某个会话
gemini --delete-session 1

Rewind：撤销错误操作

Gemini CLI 的 Rewind 功能相当于工作流的 Ctrl+Z，让你能精准回退到某个时间点。

触发 Rewind

在对话中任意时刻，输入 /rewind 或按两次 Esc。

选择回退点

你会看到最近操作的列表，选择出现问题之前的那个时间点。

选择回退范围

Rewind 支持三种模式，粒度精确：

模式	效果	适用场景
仅回滚对话	删除聊天记录，文件保持修改后的状态	代码改对了，但聊天跑偏了
仅还原文件	保留聊天记录，撤销文件改动	想保留对话上下文，重新实现
全部回滚	对话和文件都恢复到原始状态	完全推倒重来

分支会话：同时尝试多个方案

想对同一个问题尝试两种不同的实现思路，可以用会话分支功能：

1. 推进到方案分歧点
2. 用 /resume save decision-point 保存当前状态
3. 实现第一个方案
4. 用 /resume resume decision-point 分支回到保存点
5. 实现第二个方案

这样两条分支都保留了完整的历史，互不干扰。

下一步

• 了解底层安全机制：Checkpointing
• 用任务规划保持复杂会话有序：任务规划教程
• 查阅 /resume 的完整参数：命令参考

常见问题

Q: gemini -r 和 /resume 有什么区别？

A: -r 直接恢复最近一次会话（最快），/resume 打开所有历史会话的列表让你选择具体哪一个。日常续上最近工作用 -r，找几天前某次特定对话用 /resume。

Q: Rewind 能撤销删除的文件吗？

A: Rewind 记录的是 Gemini CLI 工具操作的快照，可以还原对话和 AI 执行的文件修改操作。如果文件是你手动删除的，Rewind 不能恢复，需要用 git 等版本控制工具。

Q: 会话历史会一直保存吗？会占用多少空间？

A: 默认保留 30 天，可在 settings.json 的 general.sessionRetention.maxAge 中调整（如 "7d"、"1w"）。每条会话以 JSON 格式存储在 ~/.gemini/tmp/ 下，通常几 KB 到几十 KB，一般不需要担心。