会话保存、恢复与保留

会话自动保存在 ~/.gemini/tmp/<project_hash>/chats/，包含提示与回复、工具输入输出、token 统计，以及可用的思考或推理摘要。目录切换到另一个项目时，展示的是该项目历史。

列出与继续

gemini --list-sessions
gemini --resume
gemini --resume 1

--resume（-r）无值恢复最近会话，也可给列表序号或完整 UUID。交互中 /resume 打开 Session Browser，用方向键浏览，/ 搜索 ID 或内容，Enter 继续，Esc 退出。

命名聊天检查点

/resume save decision-point
/resume list
/resume resume decision-point

/chat ... 是兼容别名，迁移期间 /resume checkpoints ... 也支持。补全菜单将自动会话浏览器与手工 checkpoints 分组；这类聊天分支点不要与文件修改前的Checkpointing混为一谈。

删除用 gemini --delete-session 2 或指定 ID；浏览器中选择会话后按 x。删除包含相关实现计划、tracker、工具输出与活动日志，不只是移除列表名称。

自动清理

默认自动清理开启，保留 30 天，maxCount 默认未定义即不按数量限制。可自定义：

{
  "general": {
    "sessionRetention": {
      "enabled": true,
      "maxAge": "30d",
      "maxCount": 50
    }
  }
}

这里 50 是示例上限，不是默认。minRetention 默认 "1d"，比它新的会话不会被自动清理；时长也可写 "24h"、"7d" 或 "4w"。

会话轮数

model.maxSessionTurns 默认 -1，表示不限。设为例如 100 后，达到上限的交互模式停止发模型请求并提示手动开始新会话；非交互模式会以错误退出。它不等于文件恢复或上下文压缩设置。

保存分歧点后尝试另一条路线

在重要设计选择前用 /resume save decision-point 保存聊天状态，再尝试第一种方案。需要回到该对话状态时，用 /resume resume decision-point 开始另一条思路。聊天分支不会自动撤销第一种方案已经造成的文件或外部修改；需要恢复代码时另行选择 Rewind 或文件检查点。

一次性会话可以用 /exit --delete 退出并删除当前历史及工具输出文件。删除会话数据不等于清理项目变更或远端记录。