name: gemini-session-management description: Gemini CLI 会话管理的中心权威。涵盖会话恢复、保留策略、会话浏览器和清理。适用于恢复 Gemini 会话、配置保留、浏览历史会话或管理会话存储。100% 委托给 gemini-cli-docs 获取官方文档。 allowed-tools: Read, Glob, Grep, Skill
Gemini 会话管理
强制要求:首先调用 gemini-cli-docs
停止 - 在提供任何关于 Gemini 会话的响应之前:
- 调用
gemini-cli-docs技能- 查询 特定的会话主题
- 基于 官方文档加载的内容
概述
用于管理 Gemini CLI 会话的元技能。会话保留对话历史,并可以恢复、搜索和配置保留策略。
何时使用此技能
关键词: session, resume, /resume, session browser, retention, maxAge, maxCount, --list-sessions, --delete-session
在以下情况使用此技能:
- 恢复之前的会话
- 配置会话保留
- 浏览历史会话
- 管理会话存储
- 理解会话限制
会话恢复
恢复上一个会话
gemini --resume
# 或
gemini -r
通过浏览器恢复
在活动会话中:
/resume
打开交互式会话浏览器以搜索和选择。
会话保留
在 settings.json 中配置自动清理:
{
"general": {
"sessionRetention": {
"maxAge": "7d",
"maxCount": 100,
"minRetention": "1d"
}
}
}
| 设置 | 描述 | 示例 |
|---|---|---|
maxAge |
最大会话年龄 | "7d", "24h" |
maxCount |
保留的最大会话数 | 100, 50 |
minRetention |
删除前的最小保留时间 | "1d", "12h" |
会话限制
配置轮次限制:
{
"general": {
"maxSessionTurns": 100
}
}
会话存储
会话存储在:
~/.gemini/tmp/<project_hash>/
命令行选项
| 选项 | 描述 |
|---|---|
--resume, -r |
恢复上一个会话 |
--list-sessions |
列出可用会话 |
--delete-session <id> |
删除特定会话 |
关键词注册表(委托给 gemini-cli-docs)
| 主题 | 查询关键词 |
|---|---|
| 恢复 | --resume flag, resume session, /resume command |
| 浏览器 | session browser, search sessions, /resume interactive |
| 保留 | sessionRetention, maxAge maxCount, session cleanup |
| 限制 | maxSessionTurns, session limits, turn limits |
| 存储 | session storage, ~/.gemini/tmp, session location |
| 管理 | --list-sessions, --delete-session, session management |
快速决策树
你想做什么?
- 恢复上一个会话 ->
gemini --resume或gemini -r - 浏览历史会话 -> 在活动会话中使用
/resume - 配置保留 -> 在 settings.json 中编辑 sessionRetention
- 列出所有会话 ->
gemini --list-sessions - 删除会话 ->
gemini --delete-session <id> - 设置轮次限制 -> 配置 maxSessionTurns
最佳实践
- 定期清理: 配置保留以避免磁盘膨胀
- 命名会话: 使用描述性提示以便轻松浏览
- 恢复上下文: 继续复杂对话
- 删除敏感数据: 移除包含敏感数据的会话
验证检查点
- [ ] 我是否调用了 gemini-cli-docs 技能?
- [ ] 官方文档是否加载?
- [ ] 我的响应是否完全基于官方文档?
测试场景
场景 1:恢复会话
查询: “如何恢复我的上一个 Gemini CLI 会话?” 预期行为:
- 技能在 “resume” 或 “session” 上激活
- 提供
gemini --resume命令 成功标准: 用户收到恢复命令和 /resume 浏览器选项
场景 2:配置保留
查询: “如何限制 Gemini 会话存储?” 预期行为:
- 技能在 “retention” 或 “session storage” 上激活
- 委托给 gemini-cli-docs 获取 sessionRetention 设置 成功标准: 用户收到 settings.json 配置,包含 maxAge/maxCount
场景 3:删除会话
查询: “如何删除旧的 Gemini 会话?” 预期行为:
- 技能在 “delete session” 或 “session management” 上激活
- 提供 --delete-session 命令 成功标准: 用户收到删除工作流程和 list-sessions 选项
参考
查询 gemini-cli-docs 获取官方文档:
- “session management”
- “session resume”
- “sessionRetention”
版本历史
- v1.1.0 (2025-12-01):添加测试场景部分
- v1.0.0 (2025-11-25):初始发布