KEEL · 龙骨 · A CURRICULUM FOR THE AI ERA
持久记忆术语地图 — keel 龙骨
Persistent Memory 的参考信息：持久记忆术语地图
第一次遇到英文术语时，先看它回答的是什么问题。英文名用于查阅文档，中文定义用于建立理解。
| 术语 | 中文定义 | 工程边界 |
|---|---|---|
| Chat history | 对话原文或消息列表 | 不是筛选后的长期事实 |
| Context | 本次模型调用实际收到的材料 | 有 token 预算，会被重新组装 |
| Run state | 当前任务的进度和中间结果 | 主要服务恢复和继续执行 |
| Checkpoint | 某个运行状态的可恢复快照 | 不自动等于长期记忆 |
| Long-term memory | 跨运行仍可能有用的信息 | 必须有作用域和生命周期 |
| Semantic memory | 稳定的事实、偏好或关系 | 不是实时权威状态 |
| Episodic memory | 带时间和来源的经历 | 历史发生过不代表现在仍成立 |
| Procedural memory | 指导 Agent 行为的规则 | 需要更高的写入权限 |
| Candidate | 模型或程序提出的记忆候选 | 没有持久化授权 |
| Record | 通过门禁后保存的正式记录 | 需要 ID、来源、作用域和状态 |
| Scope | 一条数据允许影响谁 | 应由认证上下文提供 |
| Provenance | 一条信息的来源和证据链 | 用于解释、审计和撤回 |
| Embedding | 文本的向量表示 | 只是检索索引，不是事实 |
| Retrieval | 从候选集合中找相关记录 | 必须先做作用域和状态过滤 |
| Context builder | 选择并格式化进入 prompt 的数据 | 检索结果不能未经筛选直接注入 |
| Write gate | 决定候选能否成为正式记录的策略层 | 模型不能绕过它写库 |
| TTL | 记录允许存在或使用的时间 | 不是所有记忆都应永久保留 |
| Supersede | 用新版本替代旧事实 | 不等同于物理删除 |
| Memory poisoning | 恶意或错误信息进入长期记忆 | 会跨会话持续影响 Agent |
一条记忆的最小生命周期
观察 -> 候选 -> 校验/确认 -> 保存 -> 检索 -> 使用
-> 更新/替代
-> 过期/删除
如果你在代码中看到一个类，却不能把它放到这条生命周期中，先回到对应章节，而不是继续背 API。