Skip to content
FunCoding

Search

Search docs, Skills and MCP

实验性 Auto Memory

从历史会话生成待审阅的记忆和 Skill 草稿,了解触发条件与模型数据路径。

This page has not been translated into English yet. The original Chinese version is shown below.

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 处理候选,不能把关闭开关理解成自动删除历史和草稿。