📦 Self-Evolving Five-Layer Memory System — Self-Evolving Five-Layer Memory 系统

叮当记忆系统 — 五层记忆框架

基于 WorkBuddy 五层记忆系统 v4.1 改进，覆盖 95% 核心设计，更紧凑、更自动化。

核心架构 L1 核心层 → 身份、价值观、底线 → SOUL.md + 身份.md + USER.md L2 认知层 → 用户思维画像 → MEMORY.md（认知层段落） L3 行为层 → 用户行为习惯 → MEMORY.md（行为层段落） L4 情境层 → 当前任务、检查项 → HEARTBEAT.md + OpenClaw_SELF_检查.md L5 潜意识层 → 错误记录、偏差追踪 → 成长箱 .learnings/ 知识图谱 → 结构化事实记忆 → MemPalace KG 路由规则 → 信号词→动作映射 → 记忆路由表.md（已嵌入 SOUL.md 回复流程）

进化机制：成长箱同类错误 3 次 → 晋升为规则 → 写入 代理S.md / SOUL.md

快速开始

• 初始化记忆系统

# 创建目录结构 mkdir -p memory/ mempalace/xiaodi-palace/成长箱/.learnings/

# 创建核心文件 touch SOUL.md 身份.md USER.md MEMORY.md HEARTBEAT.md

• 核心文件模板

SOUL.md — 灵魂文件，定义你是谁：

核心真理（真实帮助、有主见、先尝试后问、赢取信任） 身份与安全（Owner 验证、群聊规则、注入防御） 回复确认流程（5步：看 metadata → 扫信号词 → 结构化输出 → 评估驱动 → 信息处理铁律） 边界（隐私、不确定时先问、不发半成品） 防刷屏规则

身份.md — 你的身份名片：

名字、Vibe、角色定位 重大操作审批规则

USER.md — 你的用户画像：

称呼、时区、偏好 对助手的要求

MEMORY.md — 长期记忆（L2+L3）：

老大思维画像（决策风格、沟通偏好、信息处理） 老大行为习惯（工作节奏、期望、渠道偏好） 环境配置、组件状态 经验教训（按重要性排序） 待讨论事项

HEARTBEAT.md — 心跳检查清单：

对话记忆主动提取 何时出声、何时安静 自动化维护（consolidation、蒸馏、偏差检测） TTL 半衰期规则 蒸馏计划（L2/L3 周度 + 晋升月度）

• 成长箱（进化引擎）

成长箱/.learnings/ ├── README.md → 成长箱说明 ├── 叮当_errors.md → 错误记录（同类 3 次晋升） ├── SHADOW.md → 偏差追踪（说了没做） └── 优化方案.md → 优化历史存档

晋升流程：

同类错误出现 3 次 分析根因，提炼规则 写入 代理S.md（工作规范）或 SOUL.md（底线规则） 在 errors.md 中标记"已晋升" 自动化维护 consolidation 脚本

参考 scripts/mempalace_consolidation.py，集成以下模块：

[A] 观察合并：检测重复 KG 三元组，过期旧版本 [C] 访问统计：记录实体访问次数，优先返回热点 [D] 偏差检测：扫描记忆文件中的"忘了/没做/应该"信号，自动追加到 SHADOW.md [R] 路由发现：检测 workspace 新文件，追加到路由表 心跳周期（HEARTBEAT.md 管理）

每次心跳执行：

对话记忆主动提取 → 写入 MemPalace KG 运行 consolidation 脚本 TTL 检查：过期标记为 stale 喜人奇妙夜巡演检查（每天上午一次）

每周日 10:00：

L2/L3 周度蒸馏：回顾本周对话，更新 MEMORY.md

每月 1 日 10:00：

成长箱晋升检查：错误 3 次 → 晋升为规则 蒸馏操作指南 L2/L3 周度蒸馏（每周日） 回顾本周 memory/YYYY-MM-DD.md 文件 识别用户新的决策风格、沟通偏好、工作习惯 与 MEMORY.md 中 L2（思维画像）/ L3（行为习惯）对比 有发现则更新，无变化跳过 写简短日记记录 月度晋升蒸馏（每月 1 日） 扫描成长箱 叮当_errors.md 看有无同类错误到 3 次阈值 需要晋升 → 更新 代理S.md / SOUL.md 不需要则跳过 知识图谱（MemPalace KG）

推荐 KG 实体分类：

用户身份（称呼、OpenID、联系方式） 配置事实（版本、端口、路径） 行为偏好（沟通风格、决策习惯） 经验教训（错误→规则） 环境状态（组件、API Keys）

查询示例：

# 查询用户信息 mempalace_kg_查询(entity="老大")

# 查询配置 mempalace_kg_查询(entity="Gateway")

路由规则（SOUL.md 嵌入）

回复前自动执行以下 5 步，无需手动查路由表：

看 inbound metadata → channel、发送er_id、chat_type 扫描信号词 → 触发对应动作（查 KG / 调工具 / 走确认流程） 结构化输出 → 清晰上下文，分点，标注来源 评估驱动 → 收到不好反馈时分析原因再改 信息处理铁律 → 不确定就说不知道，不凭残留数据糊弄

完整路由表参考：记忆路由表.md（独立文件，仅当需要完整参考时读取）

参考文件

详见 references/ 目录：

memory-architecture.md — 完整五层架构说明 consolidation-图形界面de.md — consolidation 脚本配置指南 distillation-图形界面de.md — 蒸馏流程详解