在 Gemini CLI 中从您上次停下的地方继续 Session Management

Source: Google Developers Blog

December 10, 2025

编辑者注： 这项新功能得益于 Christopher Beeson，他是 Gemini CLI 社区中杰出的开源贡献者。其在九个以上精心编写的 Pull Request 中的细致工作，对实现此功能起到了关键作用。

在使用 Gemini CLI 时，情境至关重要。无论是重构复杂的代码库还是调试棘手的错误，你的对话历史都包含了有价值的推理、工具输出和决策。

以前，关闭终端意味着失去这些情境。重新开始时必须向模型重新解释问题。现在情况已经改变——Gemini CLI 现在 会自动保存你的会话，并允许你在会话历史中搜索，以在离开的地方继续！

自动保存：安心无忧

每次与你交互时，Gemini CLI 的会话现在会在后台 自动保存。你不需要记得手动保存或导出聊天记录；我们会通过全新的 会话管理 系统为你处理。

我们会捕获工作完整状态，包括：

• 你的提示和模型的回复。
• 所有工具执行（输入和输出）。
• 令牌使用统计。
• 助手的思考和推理摘要。

关键是，这些会话是 项目特定 的。如果你切换到不同项目的目录，Gemini CLI 会自动切换到该项目的会话历史，确保 Gemini CLI 始终与你保持同一情境。

恢复会话

我们让你轻松回到之前的工作流，无论你喜欢使用命令行标志还是交互式 UI。

交互式会话浏览器

在 Gemini CLI 中，只需输入 /resume 即可打开全新的 会话浏览器。

此交互界面允许你：

• 浏览： 滚动查看按时间顺序排序的过去会话列表。
• 预览： 查看消息数量和单行摘要，以便识别正确的聊天。
• 搜索： 按 / 键可通过 ID 或内容关键字过滤会话。
• 选择： 按 Enter 键即可瞬间恢复该对话的完整情境。

命令行强力

如果你更喜欢使用标志，也可以在启动 Gemini CLI 时直接恢复会话。

• 恢复最新会话： gemini --resume 将立即加载最近的会话。
• 恢复指定会话： gemini --resume 5（按索引）或 gemini --resume <session-id>（按会话 ID）。

你还可以列出当前项目的所有可用会话：

gemini --list-sessions

输出示例：

Available sessions for this project (3):

  1. Fix bug in auth (2 days ago) [a1b2c3d4]
  2. Refactor database schema (5 hours ago) [e5f67890]
  3. Update documentation (Just now) [abcd1234]

管理你的历史记录

权力越大，责任越大……或者在这里，是大量的历史文件！我们添加了工具帮助你保持环境整洁。

为防止历史记录无限增长，你可以在 settings.json 配置文件中启用自动清理策略：

{
  "general": {
    "sessionRetention": {
      "enabled": true,
      "maxAge": "30d",   // 保留 30 天的会话
      "maxCount": 50     // 保留最近的 50 个会话
    }
  }
}

跟踪你的 Gemini CLI 使用情况

详细的消息、思考、工具调用和令牌使用信息会自动记录，帮助你分析 Gemini CLI 的使用情况。你可以使用社区开发的工具，如 Splitrail，或自行开发。

今日即可开始

会话管理已在 Gemini CLI 中提供，并 默认开启（自 v0.20.0+ 起）。

更新到最新版本以使用此新功能：

npm install -g @google/gemini-cli@latest

查看 官方会话管理文档 以获取更多细节。

你也可以关注 Gemini CLI 的 X 账号 以获取最新新闻和公告。