实验性 Auto Memory
从历史会话生成待审阅的记忆和 Skill 草稿,了解触发条件与模型数据路径。
Auto Memory 在后台分析过去会话,提出长期记忆更新和可复用 Skill,默认关闭。候选内容只有经用户批准才成为后续上下文,不能把它等同于自动写入项目 GEMINI.md。
启用与候选条件
在用户 ~/.gemini/settings.json 或项目 .gemini/settings.json 配置后重启:
{
"experimental": {
"autoMemory": true
}
}服务在会话启动时运行,只考虑已空闲至少三小时且有至少 10 条用户消息的项目会话,忽略活跃、过小和 subagent 会话。锁文件避免多个实例并发提取,状态与节流避免连续启动重复扫描。
审阅 Inbox
运行 /memory inbox,分别查看新 Skill、Skill 更新和记忆更新。Skill 草稿为 SKILL.md,记忆变更为 unified diff .patch。
- 查看完整 Skill 后,提升到用户
~/.gemini/skills/或项目.gemini/skills/。 - 对已有 Skill 的 patch 可批准或拒绝。
- 查看 private/global memory diff 后再应用,或直接丢弃。
提升的 Skill 在下一会话可发现;应用记忆 patch 会更新底层文件并在当前会话重载。私人 patch 针对项目记忆目录,global patch 只针对个人 ~/.gemini/GEMINI.md,不自动提取共享项目 GEMINI.md。
处理与限制
后台 agent 默认只在证据足够时产生候选,空 Inbox 不代表故障。它不能直接编辑活动记忆、设置、凭据或项目 GEMINI.md;patch 会解析验证,记忆应用还有目标允许范围和原子写入。
历史虽然保存在本地,提取仍调用配置的模型,选中的 transcript 片段可能发到模型。官方要求提取器隐藏秘密并避免照搬大型工具输出,但不能据此宣称纯本地处理。当前提取依赖 preview Gemini Flash 模型,质量有局限。
关闭
把 experimental.autoMemory 设为 false 并重启,下次启动不再运行提取服务;已存在的 Inbox 仍在磁盘上。可以先在 /memory inbox 处理候选,不能把关闭开关理解成自动删除历史和草稿。