Docs · Memory

Memory 记忆

Memory 当前以本地优先为原则:默认保留在设备本地,长期写入需要明确确认,授权范围在检索或同步之前确定。

最后更新:2026-10-15

默认本地

当前 Memory 的基础行为是 Local Only。你可以在没有配置模型、没有网络、没有 Desktop 的情况下浏览、创建、编辑、搜索、置顶或删除本地记忆。

配置模型 Provider 并不会自动把本地 Memory 上传给 Provider。记忆同步也不是“默认全部复制”。

记忆类型与来源

当前数据模型区分 working、chat、user、task、local 等记忆类型,并保留来源信息、重要度 / 置信度、置顶状态、本地修订号和时间信息。

来自 Chat 的记忆可以保留会话 / 消息来源引用;即使源对话后续被删除,已经确认保存的 Memory 仍可以保留自己的来源元数据。

长期记忆需要确认

当前离线提取器只会从明确的用户表达中提出候选,例如“记住 / 请记住 / Remember”一类请求。候选只是预览,不会因为被识别出来就自动写入长期记忆。

用户可以修改候选内容,再执行一次明确确认。拒绝候选不会写入。对来源的校验会在真正提交前再次执行,以降低源消息变化或删除造成的竞态。

搜索、编辑与置顶

  • 支持本地文字搜索与类型 / 来源过滤。
  • 支持编辑、置顶 / 取消置顶与确认删除。
  • 更新使用修订号保护,遇到旧版本写入时应返回冲突,而不是静默覆盖。
  • 置顶记录受到额外保护,自动流程不应在没有明确用户动作的情况下覆盖或删除。

同步边界

Device Mesh 的 Memory 同步只面向明确授权的支持范围,并遵循“先授权,再检索 / 排序 / 同步”的原则。信任设备本身不等于获得全部 Memory。

Memory Graph、任意云端记忆中心和无边界后台同步不应被视为当前已经完成的能力。

开发阶段说明

Memory 数据结构与同步能力还会继续演进。重要数据建议保留独立备份,不要把预稳定版本当作唯一长期档案系统。

实现依据

本页根据 CetaMesh 当前公开仓库中的实现与工程文档整理,不把路线图中的未来能力当成现成功能。