记忆层模型总览
wesgine 记忆系统的七层闭域模型——每层的定位、特征与关系。
七层闭域
| 层名 | 用户名称 | 持久 | Actor | 说明 |
|---|---|---|---|---|
environment | 环境信息 | ✅ | 无 | 宿主感知器自动产出 |
consensus | 部门共识 | ✅ | 无 | 管理员写入的共享知识 |
about_me | 关于我 | ✅ | 有 | 个人偏好与特征 |
agent_memory | 角色记忆 | ✅ | 有 | Agent 特定的认知存储 |
session | 会话记忆 | 会话期 | 有 | 当前会话上下文 |
working | 工作缓存 | Run 期 | 有 | 当前 Run 的临时数据 |
unknown | 未识别 | — | — | 未覆盖的 scope 兜底 |
用户记忆层（前四层）
前四层是真正的「记忆」，对应用户可见的记忆中心：
- L1 环境：机器有什么（自动感知，不可写）
- L2 共识：团队约定什么（管理员写入）
- L3 关于我：我喜欢什么（个人偏好）
- L4 角色记忆：Agent 知道什么（角色认知）
运行时层（后两层）
session 和 working 是运行时状态，不是持久记忆：
session：会话期间的上下文状态working：单次 Run 的临时计算数据
这两层不可手动写入（ErrLayerNotWritable）。
unknown 层
引擎的兜底出口。未覆盖的 scope 值落到 unknown。
它存在是因为引擎可能引入新 scope，前端不应因为遇到未知层而崩溃。
层判定单点
LayerOf(entry) 是唯一的层判定函数。
消费方（前端、产品）直接读引擎返回的 layer 字段，不自行推导。
层与 Scope 的关系
层是用户视角的分组，Scope 是引擎存储分区。
两者不是一一对应：consensus 和 about_me 共用 ScopeGlobal，区别仅在 actor 列是否为空。
Layer 与 Scope 同时给出请求时返回 ErrMemoryLayerScopeConflict。
消费方规则
| 规则 | 说明 |
|---|---|
| 不推导 | 层由引擎 LayerOf 判定 |
| 不裁剪 | 七层全部渲染（含 0） |
| 不混用 | Layer 和 Scope 不能同时给 |
| 不复制 | 产品不维护第二份层映射表 |
相关文档
- 环境记忆 →
memory-environment-sensing.md - 部门共识 →
memory-consensus-layer.md - 关于我 →
memory-about-me.md - 角色记忆 →
memory-agent-memory.md - 会话/工作记忆 →
memory-session-working.md