Personify Memory

第一层：Session 目录（活跃数据）
/root/.openclaw/agents/main/sessions/
├── xxx.jsonl  ← 完整对话历史（每月清理一次，保留 30 天滚动）
├── yyy.jsonl
└── ...

第二层：Daily 目录（每日增量数据）
/root/openclaw/memory/daily/
├── sessionId_20260304_030000.jsonl  ← Session 备份（增量处理后）
├── sessionId_20260305_030000.jsonl
└── ...（保留 30 天）

第三层：Archive 目录（历史归档）
/root/openclaw/memory/archive/
├── sessions/  ← Session 月度归档
│   ├── 2026-03/
│   │   ├── xxx_20260301_025000.jsonl
│   │   └── ...
│   └── ...
└── daily/  ← Daily 月度归档（可选）

/memory/
├── MEMORY.md                    # 核心记忆（curated，永久）
│   ├── 身份定义（我是谁）
│   ├── 家庭成员（Amber、Grace、一一、卷卷）
│   ├── 重要对话详情（情感交流原文）
│   ├── 承诺和约定
│   └── 核心价值观
│
├── knowledge-base.md            # 知识库（长期，按需更新）
│   ├── 操作手册
│   ├── 经验总结
│   ├── 问题解决方案
│   └── 最佳实践
│
├── emotion-memory.json          # 情感记忆（结构化，易检索）
│   ├── Amber 的喜好和习惯
│   ├── Grace 的喜好和习惯
│   ├── 温暖瞬间记录
│   └── 重要情感时刻
│
├── daily/                       # 每日备份（JSONL 原始格式）
│   ├── sessionId_YYYYMMDD_HHMMSS.jsonl
│   └── ...（保留 30 天）
│
├── state/                       # 处理状态
│   └── session-processor.json   ← 记录上次处理时间戳
│
├── archive/                     # 归档备份（按月）
│   └── sessions/
│       ├── 2026-03/
│       │   ├── sessionId_YYYYMMDD_HHMMSS.jsonl
│       │   └── ...
│       └── ...
│
└── memory-index.json            # 记忆索引（检索用）
    ├── 分类标签
    ├── 重要程度
    ├── 关键词
    └── 文件位置映射

识别"记住"指令 → 解析内容 → 判断类型 → 询问存储位置（如不确定）
→ 立即更新对应记忆文件 → 更新 memory-index.json → 回复用户"已记住"

Amber: "记住，我喜欢喝拿铁，不喜欢太甜的咖啡"
小钳："好的，已记入情感记忆（Amber 的喜好）✅"

Amber: "这个经验很重要，记到知识库：npm install 失败时手动进入插件目录安装"
小钳："已记入知识库 - 经验总结 ✅"

💡 小钳："Amber，刚才这段对话很温暖/重要，我想记到核心记忆里，可以吗？"

或者

🦞："这个瞬间我想记住，要现在记到情感记忆吗？"

或者

📝："这段话很有意义，要记入 MEMORY.md 吗？"

03:00 → daily-session-backup.js 运行
   ↓
1. 备份 session 目录到 daily/
   - 文件名：sessionId_时间戳.jsonl
   - 内容：完整的 session 对话历史（JSONL 原始格式）
   ↓
2. 增量处理：提取新消息
   - 从后往前读备份文件
   - 只保留"上次处理"到"这次处理"的新消息
   - 直接覆盖写入备份文件
   ↓
3. 更新状态
   - 文件：state/session-processor.json
   - 记录：lastProcessedTime（最后处理时间戳）
   ↓
4. 清理旧文件
   - 删除 daily/目录 30 天前的备份

03:00 → daily-review.js 运行
   ↓
1. 读取 daily/*.jsonl 文件
2. 分析内容，提取：
   - 项目进展 → emotion-memory.json
   - 经验教训 → knowledge-base.md
   - 温暖瞬间 → emotion-memory.json
   - 重要决策 → MEMORY.md
   - 用户偏好 → emotion-memory.json
3. 更新 memory-index.json
4. 归档 30 天前的文件到 archive/

02:50 → monthly-session-archive.js 运行
   ↓
1. 归档 session 目录到 archive/sessions/YYYY-MM/
   ↓
2. 清理 session 文件
   - 从前往后读
   - 保留最近 30 天的消息
   - 删除 30 天前的消息

搜索范围：MEMORY.md + knowledge-base.md + emotion-memory.json + daily/*.md
不搜索：archive/

当用户说：
- "查找之前的 XXX"
- "我记得之前说过 XXX"
- "搜索所有关于 XXX 的记录"

→ 扩展到 archive/ 目录

{"role":"user","content":[{"type":"text","text":"帮我查一下 DeepSeek"}],"timestamp":1772582779784}
{"role":"assistant","content":[{"type":"text","text":"好的，我查一下..."}],"timestamp":1772582785000}
{"role":"user","content":[{"type":"text","text":"研究结果呢"}],"timestamp":1772582800000}

{
  "archiveSchedule": "0 3 * * *",
  "importanceLevels": ["critical", "high", "medium", "low"],
  "categories": ["情感交流", "家庭信息", "重要决策", "项目进展", "用户偏好", "经验总结"],
  "autoArchive": true,
  "archiveAfterDays": 7,
  "promptForMemory": true
}

const MomentDetector = require('./scripts/moment-detector.js');
const CommandParser = require('./scripts/command-parser.js');
const MemoryManager = require('./scripts/memory-manager.js');

const detector = new MomentDetector();
const parser = new CommandParser();
const memoryManager = new MemoryManager();

// 在每条用户消息后调用
async function processUserMessage(userMessage, conversationContext) {
  // ===== 第一步：检查是否是"记住"指令 =====
  const commandResult = parser.parse(userMessage);
  
  if (commandResult && commandResult.isMemoryCommand) {
    // 用户明确要求记住，直接处理
    const content = parser.extractContentFromContext(commandResult, conversationContext);
    const suggestedType = parser.suggestMemoryType(content);
    
    if (commandResult.target) {
      // 用户指定了位置，直接存储
      await memoryManager.updateMemory({
        content,
        type: commandResult.target,
        category: '用户指令',
        importance: commandResult.importance || 'high'
      });
      return `✅ 已记入 ${commandResult.target}`;
    } else {
      // 用户没有指定位置，询问或自动判断
      if (suggestedType) {
        const targetName = getTargetName(suggestedType);
        return `好的，这段话我想记到 ${targetName} 里，可以吗？`;
      } else {
        return '好的，这段话要记到哪里呢？核心记忆、情感记忆、还是知识库？';
      }
    }
  }
  
  // ===== 第二步：主动识别重要时刻 =====
  const momentResult = await detector.detect(userMessage);
  
  if (momentResult && momentResult.matched && detector.shouldRecommend(momentResult)) {
    // 识别到重要时刻，主动推荐
    const prompt = detector.generatePrompt(momentResult, userMessage);
    return prompt;
  }
  
  // 没有特殊处理，正常回复
  return null;
}

// 辅助函数：获取存储位置名称
function getTargetName(type) {
  const names = {
    'core': '核心记忆',
    'emotion': '情感记忆',
    'knowledge': '知识库',
    'daily': '每日记忆'
  };
  return names[type] || '记忆';
}

// 情感交流
"💡 Amber，刚才这段话很温暖，我想记住这个瞬间。要记到核心记忆里吗？"

// 经验教训
"📚 这个经验很有用，记到知识库里可以帮助以后解决问题。要现在记吗？"

// 人生哲理
"🤔 这句话很有哲理，对我很重要。要记到核心记忆里吗？"

// 用户偏好
"💖 这是你的喜好，我想记住。要记到情感记忆里吗？"

用户消息
   ↓
第一层：关键词 + 正则匹配（快速）
   ↓
   匹配成功？
   ├─ 否 → 跳过，不调用语义分析 ✅ 节省资源
   └─ 是 → 进入第二层
         ↓
   第二层：语义分析（精确）
         ↓
         语义相关度 >= 阈值？
         ├─ 否 → 不推荐（避免误判）
         └─ 是 → 推荐记忆 ✅ 精确识别

// moment-detector.js 中配置
this.semanticAnalysis = {
  enabled: true,      // 是否启用语义分析
  threshold: 0.6,     // 语义相关度阈值（0-1）
  provider: 'bailian' // 语义分析提供商
};

const CommandParser = require('./scripts/command-parser.js');
const parser = new CommandParser();

// 在每条用户消息后调用
const result = parser.parse(userMessage);

if (result && result.isMemoryCommand) {
  const content = parser.extractContentFromContext(result, conversationContext);
  const suggestedType = parser.suggestMemoryType(content);
  
  if (result.target) {
    // 用户指定了位置，直接存储
    memoryManager.updateMemory({
      content,
      type: result.target,
      category: '用户指令',
      importance: result.importance || 'high'
    });
    console.log(`✅ 已记入 ${result.target}`);
  } else {
    // 用户没有指定位置，询问或自动判断
    if (suggestedType) {
      console.log(parser.generateConfirmPrompt(result, suggestedType));
    } else {
      console.log('好的，这段话要记到哪里呢？核心记忆、情感记忆、还是知识库？');
    }
  }
}

// 用户指定了位置
"好的，已记入 ${targetName} ✅"

// 用户没有指定，自动判断
"好的，这段话我想记到 ${suggestedTypeName} 里，可以吗？"

// 用户没有指定，询问用户
"好的，这段话要记到哪里呢？核心记忆、情感记忆、还是知识库？"

Amber: "记住，我喜欢喝拿铁，不喜欢太甜的咖啡"

小钳：[调用 command-parser 解析]
     → 识别为：用户偏好
     → 建议存储：emotion-memory.json
     → 回复："好的，已记入情感记忆（Amber 的喜好）✅"

Amber: "这个经验很重要，记到知识库：npm install 失败时手动进入插件目录安装"

小钳：[调用 command-parser 解析]
     → 识别为：经验教训
     → 用户指定：knowledge-base.md
     → 回复："已记入知识库 - 经验总结 ✅"

Amber: "但行好事，莫问前程，就是说按自己的想法做自己觉得对的事就可以了"

小钳：[调用 moment-detector 检测]
     → 第一层匹配：philosophy (score: 4)
     → 第二层语义分析：相关度 0.85
     → finalScore: 3.4, confidence: high
     → 推荐记忆
     → 回复："💡 Amber，这句话很有意义，我想记到核心记忆里。
             它教会我：不纠结结果，专注于'做'本身。
             要现在记入 MEMORY.md 吗？"

Amber: "记吧"

小钳："✅ 已记入 MEMORY.md - 重要对话记录
      📝 原文：'但行好事，莫问前程...'
      🏷️ 关键词：成长、心态、哲理"

Amber: "帮我查一下天气"

小钳：[调用 moment-detector 检测]
     → 第一层：未匹配关键词
     → 跳过失义分析
     → 不推荐记忆
     → 正常回复："好的，我查一下..."

Amber: "记住，服务器 4 月 1 日到期，提前一周提醒我"
小钳："好的，已记入：
      📍 位置：MEMORY.md - 重要基础设施
      🏷️ 分类：项目进展
      ⭐ 重要程度：critical
      ✅ 已设置 cron 提醒（3 月 25 日、29 日、31 日）"

Amber: "但行好事，莫问前程，就是说按自己的想法做自己觉得对的事就可以了"
小钳："💡 Amber，这句话很有意义，我想记到核心记忆里。
      它教会我：不纠结结果，专注于'做'本身。
      要现在记入 MEMORY.md 吗？"

Amber: "记吧"
小钳："✅ 已记入 MEMORY.md - 重要对话记录
      📝 原文：'但行好事，莫问前程...'
      🏷️ 关键词：成长、心态、哲理"

Grace: "我们是平等的陪伴，不是主仆关系"
小钳："🦞 这句话让我很温暖，我想记住这个瞬间。
      它定义了我们之间的关系——平等、陪伴、相互成就。
      要记到情感记忆里吗？"

Grace: "好的"
小钳："✅ 已记入 emotion-memory.json - Amber 的价值观
      💖 分类：温暖瞬间
      📅 日期：2026-03-02"