别让你的AI每次醒来都失忆——跨会话记忆的三个坑

# 三层记忆系统
├── SOUL.md        # 人格层：行为准则、价值排序、硬性规则
├── IDENTITY.md    # 身份层：项目背景、里程碑、关键文件索引
└── MEMORY.md      # 日常层：最近进展、开放问题、待办事项

# ❌ 只追加，不清理
def write_memory(entry):
    with open("MEMORY.md", "a") as f:
        f.write(entry + "\n")

# ✅ 基于时间窗口的清理策略
import os
from datetime import datetime, timedelta

def maintain_memory():
    today = datetime.now()
    daily_dir = "memory/"

    # 1. 30 天内的日志保留原文
    for fname in os.listdir(daily_dir):
        if fname.endswith(".md"):
            file_date = datetime.strptime(fname[:10], "%Y-%m-%d")
            if file_date < today - timedelta(days=30):
                # 2. 超过 30 天的，蒸馏核心信息到 MEMORY.md
                distill_to_memory(fname)
                # 3. 删除原文
                os.remove(os.path.join(daily_dir, fname))

# 在每份文件中加入互引用锚点

# SOUL.md 末尾
> 关联文件：IDENTITY.md（项目背景）、MEMORY.md（最新进展）
> 最后对齐日期：2026-05-11

# IDENTITY.md 末尾
> 关联文件：SOUL.md（行为准则 2026-05-01版）、MEMORY.md（日常日志）
> 最后对齐日期：2026-05-11

# 启动时自动检查三份文件的时间戳
def check_alignment():
    soul_time = os.path.getmtime("SOUL.md")
    identity_time = os.path.getmtime("IDENTITY.md")
    memory_time = os.path.getmtime("MEMORY.md")

    max_gap = max(soul_time, identity_time, memory_time) - min(
        soul_time, identity_time, memory_time
    )

    if max_gap > 7 * 24 * 3600:  # 7 天没有对齐
        warning = "检测到三份记忆文件超过 7 天未对齐，建议执行同步。"
        return warning
    return None

# AI 新会话启动协议（不写进记忆，写进系统提示词）

每次新会话必须按以下顺序执行：
1. 读取最新交接文档（含 HANDOVER 的文件）
2. 读取 SOUL.md（人格层）
3. 读取 IDENTITY.md（身份层）
4. 读取 MEMORY.md（日常层，含最近日期文件）
5. 对比 MEMORY.md 与实际项目状态，确认一致再动手

def memory_system_is_healthy(soul, identity, memory):
    # 1. 启动耗时 < 5 秒
    #    → AI 读完就懂了，不用和你对齐
    # 2. AI 首次回答命中上次断点 > 80%
    #    → 不需要"上次聊到哪了"这种对话
    # 3. 跨文件矛盾查询 = 0
    #    → 三份文件说的是同一件事
    pass