DeepTide记忆系统深度解析:MEMORY.md如何让AI跨会话记住你的项目

原创2026-10-15 20:52:062,133 阅读

DeepTide记忆系统深度解析:MEMORY.md如何让AI跨会话记住你的项目

DeepTide 记忆系统深度解析:作为一款由 DeepSeek 打造、面向 macOS 的 Swift 原生 AI 编码助手(coding agent),DeepTide 解决了一个几乎所有 AI 编程工具的通病——如何让 AI 跨会话记住你的项目。答案就藏在一份名为 MEMORY.md 的纯文本索引文件里。本文将带你彻底弄懂 DeepTide 的记忆系统:记忆存到哪里、怎么注入 AI、如何按需检索,以及它如何用「前缀缓存对齐」这一巧妙设计,让长期跨会话记忆既准确又省钱。

💡 一句话概括:DeepTide 的记忆 = 记忆分片(.md 文件)+ MEMORY.md 索引 + 缓存核心注入 + MemorySearch 按需检索 + Dream 自动整合。

为什么 AI 编码助手需要"跨会话记忆"

每次打开新的对话窗口,AI 都像"失忆"一样重新认识你的项目:它不知道你喜欢 pnpm 而不是 npm,不知道你项目的测试约定,也忘了上次你纠正过它的某个做法。结果就是——同一个偏好,你不得不反复交代。

DeepTide 的记忆系统正是为了解决这个问题。它把"值得长期记住的事实"沉淀到磁盘上的纯文本文件里,让 AI 在下一次、下下次会话里依然"记得"。核心目标只有两个:

  • 准确性:该记住的记住,不该记的别乱记(避免"记忆污染")。
  • 经济性:记忆每轮都要随提示词重发给模型,成本必须压到最低。

下面我们从存储到检索,逐层拆解这套机制。

DeepTide 记忆系统架构:三层结构一览

DeepTide 把记忆抽象成「存储 → 注入 → 检索」三层,对应代码里的"两层记忆"(缓存核心 + 按需长尾)设计:

记忆分片 (*.md)  →  MEMORY.md 索引  →  缓存核心 (前 200 行 / 25KB)  →  系统提示词
                                            ↘
                                             长尾内容  →  MemorySearch 按需检索
层级 作用 对应实现
存储层 每条记忆是一个带元信息的 .md 分片,MEMORY.md 是它们的"目录" memory.rs
注入层 把记忆"核心"拼进系统提示词,每轮 AI 都能"读到" prompt.rs#L137-L164
检索层 超出核心的长尾记忆,用时通过 MemorySearch 按相关性捞出来 tools/memory.rs

这个分层的关键好处:AI 每轮常驻的只有精简核心(快、省 token),而完整的记忆库躺在磁盘上,需要时才查(不占用宝贵的上下文窗口)。

MEMORY.md 存储在哪里:项目记忆 vs 全局记忆

DeepTide 的记忆按**作用域(scope)**分成两类,分别存放:

  • 项目记忆(project):只属于当前项目,路径形如 ~/.config/tide/projects/<项目slug>/memory/
  • 全局记忆(global):跨项目通用(比如"我喜欢简洁的注释"),路径形如 ~/.config/tide/memory/

其中"项目 slug"是由当前工作目录路径转换而来(把 / 换成 -,过长时截断并追加一段哈希),保证不同项目各自独立、互不串味。相关的路径计算逻辑在 memory.rs#L34-L62。

🔧 小贴士:目录根可以被环境变量 TIDE_CONFIG_DIR 覆盖,方便多配置隔离。老版本曾用 <项目>/.deeptide/memory/ 存放(遗留目录),现在仍会自动兼容读取,无需手动迁移。

每个作用域目录下,除了 MEMORY.md 这个索引,其余 .md 文件就是具体的"记忆分片"。

一条记忆的"长相":记忆分片文件格式

每条记忆都是一个带 YAML frontmatter 元信息 的小文件。这是 memory.rs#L187-L197 生成的标准格式:

---
name: Coding Style
description: Prefer focused tests
type: project
---

Keep tests narrow and deterministic.

四个字段各司其职:

  • name:记忆标题(≤ 80 字符),相当于这条记忆的"身份证"。
  • description:一句话说明"为什么记这条"(≤ 240 字符),帮助检索命中。
  • type:记忆类别,取值为 user(用户偏好)、feedback(纠正/反馈)、project(项目约定)、reference(参考资料)四类。
  • 正文:真正的记忆内容(≤ 2000 字符,刻意保持精炼)。

文件名则由标题自动 slug 化生成(如 Coding Style → coding-style.md),重名时自动追加 -2、-3 后缀。而 MEMORY.md 索引里对应的一行长这样:

- Coding Style - Prefer focused tests

你可以直接把 MEMORY.md 理解成一份"带说明的目录清单"——点进去就能定位到具体分片。

记忆如何进入 AI 大脑:系统提示词注入机制

会话启动时,DeepTide 会构建一份系统提示词(system prompt),记忆是其中的固定一层。在 prompt.rs#L137-L164 中,提示词的拼装顺序是:

  1. 身份与行为准则
  2. 运行环境信息
  3. 项目指南(CLAUDE.md / TIDE.md / AGENTS.md / ZERO.md)
  4. 记忆(MEMORY.md 内容) ← 就注入在这里

load_memory_prompt 会同时读取全局 + 项目两份记忆,并把索引里的每条 - 标题 展开成对应文件的完整正文再拼接。注入后,提示词里会出现两个区块:

# auto memory
<全局记忆正文……>

# project memory
<项目记忆正文……>

但这里有个关键约束——不能把所有记忆一股脑塞进去。truncate_memory 会把注入内容截断在前 200 行 / 25KB(见 memory.rs#L494-L557)。超出部分不会丢,而是在末尾追加一句提示,引导 AI 用 MemorySearch 去"按需取回":

...(memory core capped at 25 KB; 42 more lines available via MemorySearch)...

这就是"缓存核心 + 长尾检索"两层记忆的落点:核心常驻,长尾随取。

跨会话记忆的核心秘诀:前缀缓存对齐(0% → 95.5%)

这是整个记忆系统里最"巧"的设计,也是 DeepTide 跨会话记忆既准又省的根源。

模型 API 通常有自动前缀缓存:只要每次请求的"前缀"逐字节不变,缓存就能命中,命中部分的输入费用约为未命中的 1/10(约便宜 10 倍)。对"每轮都重发一大段提示词"的 Agent 循环来说,这几乎是最大的成本杠杆。

问题在于:记忆每轮都在变(可能随时新增一条),前缀一抖,缓存瞬间失效。DeepTide 的解法在 truncate_memory 里——它只在整行边界处截断,绝不在行中间切,从而保证:

  • 注入的核心前缀逐字节稳定;
  • 在索引末尾追加新记忆,绝不扰动已保留的头部(新条目只往后加)。

效果有多猛?来自 benchmarks/README.md 的实测对比:

提示词布局 前缀缓存命中率
把易变内容(日期/轮次)放最前 0.0%
记忆块每轮重排 67.6%
稳定前缀、易变内容放最后(DeepTide 方案) 95.5%

⚠️ 一个反直觉的教训:哪怕前缀最前面只多了一个"会变"的 token(比如一个时间戳),命中率就会从 ~95% 崩到 0%,等于输入成本翻 10 倍。

因此 DeepTide 立了两条"硬规则"并由代码/测试强制保障:系统提示词里禁止出现易变内容(日期、时钟、轮次计数);记忆块必须逐轮字节稳定。这套规则由 memory.rs#L482-L557 的实现与配套的 cache_alignment_tests 单元测试共同守护。

按需找记忆:MemorySearch 如何用 BM25 检索

当核心装不下、或 AI 需要精确回忆时,它会调用 MemorySearch 工具。参数很简单:query(查询词)、scope(project / global / all)、max_results(1–50,默认 10)。

它不是简单的"包含匹配",而是用 BM25 相关性打分 + 轻度"新鲜度"加权(见 memory_rank.rs):

  • BM25 是经典的信息检索算法,衡量"这条记忆和你的查询词有多相关";
  • 停用词过滤(the / is / of 等)避免"只因为共享一个虚词就误命中";
  • 新鲜度只做"打破平局"的微弱加分(权重仅 0.1),保证真正相关的记忆永远排在前面。

最关键的保证:与查询零重叠的文件会被直接丢弃——MemorySearch 永远不会返回无关记忆。命中后还会展示"匹配行"(与查询词重合最多的那一行),让 AI 一眼定位证据。

谁来写记忆:手动命令 + Dream 自动整合

记忆的"写入"有两条路径:

① 手动(用户/Agent 主动)

命令 作用
/remember <文本> 存一条带时间戳的项目记忆
/memory 列出全部记忆(项目 + 全局)
/memory show <名称> 查看某条记忆详情
/memory delete <名称> 删除某条记忆(连同索引一并清理)

命令实现见 commands.rs#L508-L597;执行 /memory 时,DeepTide 会用 * / o 标记"该作用域是否已创建",并逐条列出分片及其说明(commands.rs#L660-L697)。

② 自动(Dream 整合)

DeepTide 内置了一个叫 /dream 的"做梦"机制——它会自动把一段会话历史浓缩成长期记忆:

/dream run                  # 立即跑一次整合
/dream start --every 25     # 每 25 轮自动整合一次
/dream stop / status        # 停止 / 查看状态

整合本质上是一次受约束的 Agent 回合(上限 8 轮),只允许用 MemorySearch + MemoryWrite,并且会去重,不会重复记已存在的事实(逻辑见 repl.rs#L3330-L3396)。

更贴心的是会话结束自动整合:退出(/exit / Ctrl-D)时会自动跑一次记忆浓缩。不想要的话,加 --no-session-capture 或在配置里把 session_end_capture 设为 false 即可跳过。

🧠 还有一条"自动捕获"(memory_capture.rs)在建:会话结束时让模型自己提炼"值得长期记住的事实",带置信度过滤(<0.6 丢弃)+ 与已有记忆去重。基准测试显示它对植入事实 100% 召回、0% 误报,单次成本约 ¥0.001——便宜到可以每次会话都跑。目前它作为"待确认再写入"的构件就绪,始终只提议、不静默落盘。

记忆卫生:自动去重与失效检测

只增不减的记忆索引会慢慢"腐烂"——同一事实被用不同措辞记了两遍,或某条记忆还在引用一个早已删除的文件。memory_hygiene.rs 专门负责检测这类问题:

  • 近似重复检测:用 Jaccard / 重叠系数找出"换个说法的重复项";
  • 失效引用检测:从记忆里抽出形如 crates/x/src/y.rs 的路径引用,标记已不存在的"死引用"。

需要注意:这里只负责"发现",删除始终交由用户确认后执行——避免 AI 擅自删掉你珍视的记忆。

快速上手:5 条命令玩转 DeepTide 记忆

安装 DeepTide 后(macOS 原生版或 CLI 版),进入项目目录启动 tide,就能用:

/remember 本项目用 pnpm,永远别用 npm      # 存一条项目约定
/memory                                      # 看看都记了啥
/memory show pnpm                            # 查看某条详情
/dream start --every 25                      # 开启每 25 轮自动整合
/memory delete pnpm                          # 不需要了就删掉

就这么简单——记住、查看、自动整合、清理,全部用斜杠命令完成。

常见问题 FAQ

Q1:记忆存在哪?会不会被上传? 项目记忆在 ~/.config/tide/projects/<slug>/memory/,全局记忆在 ~/.config/tide/memory/,都是本地纯文本文件,你可以直接用编辑器查看、修改。

Q2:记忆会无限膨胀占满上下文吗? 不会。每轮注入的核心被硬截断在前 200 行 / 25KB,超出的长尾靠 MemorySearch 按需取回;再配合 Dream 去重与记忆卫生,能长期保持精简。

Q3:为什么强调"前缀稳定"? 因为它直接决定成本——稳定前缀能让 DeepSeek 前缀缓存命中率保持 ~95.5%(便宜约 10 倍),一个易变 token 就能让命中率归零。

Q4:AI 能自己写记忆吗? 能。Agent 通过 MemoryWrite 工具落盘,/dream 与"会话结束整合"会自动驱动这一过程,且内置去重,避免重复记录。

Q5:如何避免 AI 记了不该记的东西? MemoryWrite 有长度上限(正文 2000 字符),自动捕获有置信度阈值,记忆卫生会揪出重复与死引用,且关键删除操作始终需你确认。

总结

DeepTide 的记忆系统用一份朴素的 MEMORY.md 索引,撑起了一整套跨会话长期记忆能力:

  • 分层存储:分片 + 索引 + 缓存核心 + 长尾检索,常驻精简、取用按需;
  • 缓存对齐:逐行稳定前缀,把跨会话记忆的成本压到最低(~95.5% 命中率);
  • 智能检索:BM25 + 新鲜度加权,只返回真正相关的记忆;
  • 自动沉淀:/dream 与会话结束整合,让 AI 越用越懂你的项目。

对新手而言,你几乎不需要"懂原理"——只要 /remember 一句、/dream 一开,剩下的交给 DeepTide。而对想深挖的读者,真正的宝藏就在 crates/deeptide-core/src/ 下的 memory.rs、tools/memory.rs、memory_rank.rs 与 benchmarks/README.md 里。

登录后查看全文
deeptide