记忆层模型
wesclaw 基于 wesgine 引擎的七层记忆体系，每一层有明确的语义、可见性规则和写入约束。理解层模型是有效使用记忆功能的基础。
七层概览
| 层 | 英文标识 | 含义 | 可写性 |
|---|---|---|---|
| 环境信息 | environment | 宿主机环境事实（OS、已安装工具等） | ❌ 引擎自动感知，不可手动写入 |
| 部门共识 | consensus | 团队/组织级共享知识 | ✅ 需要管理员权限 |
| 关于我 | about_me | 用户个人偏好与习惯 | ✅ 用户可写 |
| 角色记忆 | agent_memory | Agent 级别的专属记忆 | ✅ 用户可写（需指定命名空间） |
| 会话记忆 | session | 当前会话的临时上下文 | ❌ 运行时自动管理 |
| 工作缓存 | working | Run 执行期间的临时数据 | ❌ 运行时自动管理 |
| 未识别 | unknown | 引擎兜底分类 | ❌ 不应主动写入 |
桌面 N=1 场景的实际意义
wesclaw 桌面版是单用户单 Cell 场景，各层的实际表现：
- environment：引擎启动时自动感知你的操作系统、已安装的开发工具、Shell 版本等，作为 AI 回答的背景知识
- consensus：在个人版中通常为空（没有团队成员写入共识），但层本身始终存在并显示为
0 - about_me：你告诉 AI 的个人偏好，例如"我喜欢简洁的回答""我使用 VS Code"
- agent_memory：每个 Agent 独立积累的知识，例如法律助手记住的法规要点
- session / working：运行时状态，不在记忆中心显示
可见性规则
记忆的可见性由引擎在召回时自动判定：
- 共享层（environment、consensus）：Cell 内所有 Actor 可见
- 私有层（about_me、agent_memory）：仅归属 Actor 可见
- 桌面 N=1 时所有层对唯一用户透明，无需关心归属问题
- 记忆中心的七个层芯片始终全部显示，计数为 0 也会画出来——这是为了区分"这层是空的"与"这层不存在"
写入约束
通过记忆中心手动管理记忆时：
- 只有
consensus、about_me、agent_memory三层可以手动写入和导入 environment层由引擎宿主感知器产出，拒绝人工导入session和working是运行时状态，不可手动写入- 写入
consensus需要管理员权限（桌面版默认具备） - 写入
agent_memory必须指定命名空间（即目标 Agent）
AI 如何使用记忆
AI 在每次对话中通过三条路径自动注入记忆：
- Eager 注入：系统提示词中直接嵌入高优先级记忆（约束、指令等）
- Lazy 召回：当轮对话相关的记忆通过语义检索动态注入
- Cold-start 注入：跨会话摘要在新会话首轮重放历史上下文
被标记为 stale（30+ 天零召回）或 conflicted（被更新条目取代）的记忆会从自动注入中排除，但仍可通过显式搜索找到。
相关文档
- 记忆中心使用 →
memory.md - 数据隔离模型 →
data-isolation.md - Agent 创建与配置 →
agent-creation.md