记忆管理
WesCraft 内置完整的记忆管理系统，帮助 AI 在多次对话间积累和运用知识。记忆按七层模型组织，支持个人版与团队版两种部署形态。
记忆的七层模型
WesCraft 的记忆系统基于 wesgine 引擎的七层分层架构，每一层有明确的职责和可见性规则：
| 层级 | 名称 | 说明 |
|---|---|---|
| L1 | 环境信息（environment） | 宿主系统自动感知的环境事实，如操作系统、已安装工具等 |
| L2 | 部门共识（consensus） | 团队版中由管理员写入的组织级知识，全员可见 |
| L3 | 关于我（about_me） | 用户个人偏好、习惯等，仅本人可见 |
| L4 | 角色记忆（agent_memory） | 特定 Agent 积累的专业知识，按 Agent 命名空间隔离 |
| L5 | 会话记忆（session） | 当前对话的临时上下文 |
| L6 | 工作缓存（working） | 运行时中间状态 |
| L7 | 未识别（unknown） | 引擎兜底分类 |
其中 L1-L4 是持久记忆层，会在记忆中心展示；L5-L6 是运行时状态，不显示在记忆面板中。
个人版与团队版的差异
个人版（默认）：
- 只有一个 Cell（
"personal"），actor 固定为"local" - L2 共识层通常为空（无管理员写入场景）
- L3 与 L2 事实上属于同一人，但仍分开渲染（为未来接入登录做准备）
- 所有七层芯片恒定渲染，计数为 0 也显示
团队版（规划中）：
- 一个团队共享一个 Cell，多成员各自有独立 actor
- L2 由管理员维护，全员可见
- L3 按 actor 隔离，张三看不到李四的个人偏好
- L4 中的共享通道（如
shared）全员可见，个人 Agent 记忆按 actor 隔离
记忆中心的使用
打开记忆中心后，你会看到七层芯片标签和对应的记忆条目列表：
- 浏览记忆：点击层级芯片切换查看不同层的记忆条目
- 搜索记忆：在搜索框中输入关键词，支持语义搜索
- 新增记忆：可手动添加记忆到
about_me、consensus（需管理员）或agent_memory层 - 删除记忆：单条删除或按层清空（仅限可写层）
- 查看计数：每层标签旁显示条目数量，0 也会显示
注意：
environment层由系统自动感知，不支持手动导入；session和working层是运行时状态，不可手动编辑。
记忆导入与导出
导入记忆
支持将外部记忆批量导入到可写层：
- 支持的目标层：
about_me、agent_memory、consensus（需管理员权限） - 导入格式：每行一条记忆文本
- 导入时自动生成 embedding 用于后续语义召回
导出记忆
可将指定层的记忆导出为文本文件，用于备份或迁移到其他 Cell。
记忆的自动维护
引擎会在后台自动维护记忆质量：
- 去重：相似度过高的条目会被合并
- 冲突检测：较新条目否定较旧条目时，旧条目被标记为冲突
- 过期清理：长时间未被召回的条目会被标记为 stale
- GC 回收：基于召回频率加权的淘汰策略，而非简单的 LRU
相关文档
- AI 交互模式 →
ai-interaction.md - Agent 管理 →
agents.md - 设置 →
settings.md - 团队协作 →
team-collaboration.md