记忆文件与作用范围
将长期事实保存到合适的 Markdown 层级，避免重复和误共享。
This page has not been translated into English yet. The original Chinese version is shown below.
Gemini CLI 通过 write_file 或 replace 编辑 Markdown 来保存长期偏好和项目事实。它不是只能在当前聊天里记住一句话，而是将文字保存为以后上下文系统可加载的文件。
保存到哪里
| 内容 | 位置 |
|---|---|
| 团队共享项目说明 | 仓库中的 GEMINI.md |
| 项目私有笔记 | 该项目的 private memory 目录 |
| 跨项目个人偏好 | ~/.gemini/GEMINI.md |
可以直接要求记住稳定偏好、架构决定或常用配置，并检查落到哪一层。官方本页没有给出统一可手写的私有目录路径，不将猜测路径当作配置约定。
检查是否生效
/memory show 检查当前加载的完整文字；手动修改后 /memory reload 刷新。保存文件并不证明内容正确，应检查事实仍有效、是否适合共享以及有无重复。
只保留简短、持久、有作用范围的说明。易变 IP、环境信息或服务状态需要定期重新核实，避免旧值被未来任务当作当前事实。
与其他机制的区别
会话历史保存具体交互，记忆文件提炼长期说明；Auto Memory从过去会话提出草稿，再由用户审阅。它们不能代替事实来源或权限限制，也不应保存秘密值作为“方便以后调用”的记忆。