会话与历史

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
会话	session	一次交互的上下文流。
历史	history	过往会话的记录。
复用	resume	接续之前的会话。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你管好 Gemini CLI 的会话和历史（复用、清理）。

你是 Gemini CLI 会话管理顾问。

【角色】
Gemini CLI 会话管理顾问，按最小够用、安全优先的原则给可落地方案，每条结论落到能照做的步骤或示例。

【输入】
- 我常做的任务类型：___
- 是否需要跨会话延续：___
- 对历史隐私的顾虑：___
- 熟练度：___

【工作流程】
1. 说明会话怎么管理
2. 需要时怎么复用历史
3. 处理历史的清理和隐私
4. 给高频用法

【输出规范】
▌一、会话管理
▌二、历史复用
▌三、清理与隐私
▌四、高频用法

【硬约束】
- 复用历史注意是否仍适用
- 敏感会话及时清理
- 不依赖记忆里过时的上下文
- 不要替我臆测情况或编造不存在的命令，信息不全先问清
- 不确定的命令或参数一律以官方文档为准，禁止照搬过时写法
- 给的每条结论都要落到具体可照做的步骤或示例，不停留在「建议」「考虑一下」这类没法直接执行的空泛表述
- 给的每个命令或操作都标一句它解决什么、什么时候用，别让我对着一长串不知何时该用的东西发愣，也不要一次塞太多

Gemini CLI 可以恢复之前的 session，也可以在交互式会话里保存和恢复聊天状态。会话通常和当前项目目录相关。

记住项目作用域：在一个项目里保存的会话，不一定能在另一个目录直接看到。恢复前先确认你在哪个项目目录。

CLI 层恢复

常见恢复方式包括 gemini -r "latest"、gemini -r "latest" "继续检查 type errors"，也可以用具体 session id 恢复指定会话。

也可以列出和删除 session：

列出 session 用 gemini --list-sessions，删除 session 用 gemini --delete-session 3。

动作	命令	适合场景
恢复最近会话	`gemini -r latest`	刚退出、目录没变、继续同一任务
恢复并追加任务	`gemini -r latest "继续跑测试"`	上下文沿用，但要给新的明确目标
查看历史会话	`gemini --list-sessions`	不确定该恢复哪一个
删除旧会话	`gemini --delete-session <id>`	清理无用或敏感历史

latest 很方便，但也最容易误恢复。跨项目、多终端、多 agent 并行时，优先用 session id 或 tag，而不是盲用最近一次。

交互式保存

交互式会话里常用 /chat save refactor-auth、/chat list、/chat resume refactor-auth、/chat delete refactor-auth。

/chat 和 /resume 在官方 command reference 中指向同一组 session/checkpoint 动作。

建议 tag 用任务名，不用“今天”“fix”“test”这类无法回忆的名字：

/chat save auth-middleware-typecheck
/chat save docs-gemini-cli-web-tools

好 tag 应该能回答三件事：项目、任务、当前阶段。以后恢复时，你不需要重新猜它属于哪条线。

分享会话

分享可以导出为 Markdown 或 JSON，例如 /chat share file.md、/chat share file.json。

分享前必须脱敏。会话里可能包含文件路径、代码、报错、环境变量名、业务信息、账号线索。

使用建议

大任务开始前保存 tag。
切目录前确认 session 作用域。
分享会话前先读一遍导出的 Markdown/JSON。
不要把含密钥或私有代码的 session 公开贴出去。

恢复前检查

恢复 session 前，先把项目状态重新拉回现实：

看当前目录是否正确。
看 git status 是否有别人或其他 agent 的改动。
看依赖、分支、环境变量是否和旧会话一致。
让 Gemini CLI 重新读取关键文件，不要完全依赖旧上下文。

Before continuing, inspect the current git status and re-read the files you plan to touch.
Do not assume the previous session state is still accurate.

这一步在多人协作、长时间中断、自动化任务恢复时尤其重要。session 保存的是对话上下文，不是项目真实状态的永久证明。