docs/memory/index.mdx
长期记忆保存在工作空间文件中,跨会话持久存在。Agent 在对话中通过检索工具按需加载历史记忆,也会在上下文裁剪时自动将对话摘要写入长期记忆。
存储在 ~/cow/MEMORY.md 中,包含用户的长期偏好、重要决策、关键事实等不会随时间淡化的信息。Agent 可通过工具读写此文件来维护长期知识。
存储在 ~/cow/memory/ 目录下,按日期命名(如 2026-03-08.md),记录每天的对话摘要和关键事件。仅在首次写入时创建,避免生成空文件。
Deep Dream(记忆蒸馏)过程的副产物,记录每次整理的发现、去重合并操作和新洞察。存储在 ~/cow/memory/dreams/ 目录下,按日期命名。
Agent 通过以下机制自动将对话内容持久化为长期记忆:
所有记忆写入均在后台异步执行(LLM 总结 + 文件写入),不阻塞正常对话回复。
记忆系统支持混合检索模式:
Agent 会在对话中根据需要自动触发记忆检索,将相关历史信息纳入上下文。检索结果按混合评分排序(默认向量权重 0.7、关键词权重 0.3),日级记忆会随时间衰减(半衰期 30 天),核心记忆不衰减。
工作空间(默认 ~/cow)中与记忆相关的文件:
| 文件 | 说明 |
|---|---|
AGENT.md | Agent 的人格和行为设定 |
USER.md | 用户身份信息和偏好 |
RULE.md | 自定义规则和约束 |
MEMORY.md | 核心记忆(长期) |
memory/YYYY-MM-DD.md | 日级记忆(按需创建) |
memory/dreams/YYYY-MM-DD.md | 梦境日记(Deep Dream 自动生成) |
在 Web 控制台的记忆管理页面中,可浏览记忆文件和梦境日记,支持通过 Tab 切换查看:
<Frame> </Frame>| 参数 | 说明 | 默认值 |
|---|---|---|
agent_workspace | 工作空间路径,记忆文件存储在此目录下 | ~/cow |
agent_max_context_tokens | 最大上下文 token 数,超出时裁剪并总结写入记忆 | 50000 |
agent_max_context_turns | 最大上下文轮次,超出时裁剪并总结写入记忆 | 20 |