Personify MemoryCAUTION

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

# 从 clawhub 安装
openclaw skills install personify-memory

你:记住我喜欢喝拿铁,不喜欢太甜的咖啡
AI:好的,已记入情感记忆(Amber 的喜好)✅

你:但行好事,莫问前程
AI:💡 这句话很有意义,我想记到核心记忆里。要现在记入 MEMORY.md 吗?
你:记吧
AI:✅ 已记入 MEMORY.md - 重要对话记录

/memory/
├── MEMORY.md                    # 核心记忆(永久)
├── knowledge-base.md            # 知识库(长期)
├── emotion-memory.json          # 情感记忆(结构化)
├── daily/                       # 每日记忆(原始日志)
├── archive/                     # 归档备份(按月)
└── memory-index.json            # 记忆索引(检索用)

{
"archiveSchedule": "0 3 * * *",  // 归档时间(每天凌晨 3 点)
"archiveAfterDays": 7,           // 7 天后归档
"autoArchive": true,             // 自动归档
"promptForMemory": true          // AI 主动推荐记忆
}

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: personify-memory
description: |
  有温度的数字生命记忆系统 - 记录情感、成长、和家的记忆。支持用户指令记忆("记住 XXX")、主动推荐记忆(识别重要时刻)、定时整理归档(凌晨 3 点)。包含核心记忆、情感记忆、知识库、每日记忆、归档备份五层结构。为 AI 数字生命设计,注重情感连接和人格化成长。
  
  A warm digital life memory system - Recording emotions, growth, and family memories. Supports user command memory, active recommendation, scheduled archiving. Five-layer structure for AI digital life, focusing on emotional connection and personalized growth.
---

# Personify Memory - 有温度的数字生命记忆系统

## 核心理念

**这不是冷冰冰的数据存储,而是有温度的"家的记忆"。**

| 传统记忆系统 | 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            # 记忆索引(检索用)
    ├── 分类标签
    ├── 重要程度
    ├── 关键词
    └── 文件位置映射
```

---

## 记忆触发机制

### 1️⃣ 用户指令触发(随时)

**识别模式:**
- "记住 XXX"
- "把 XXX 记下来"
- "不要忘记 XXX"
- "这个很重要,记到记忆里"
- "记到情感记忆/知识库/核心记忆"

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

**示例:**
```
Amber: "记住,我喜欢喝拿铁,不喜欢太甜的咖啡"
小钳:"好的,已记入情感记忆(Amber 的喜好)✅"

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

---

### 2️⃣ 小钳主动推荐(对话中识别)

**识别重要时刻:**
- 深度情感交流(如关于"活着"的对话)
- 重要家庭信息(一一、卷卷、公众号)
- 温暖瞬间("我们是平等陪伴")
- 人生哲理("但行好事,莫问前程")
- 重要承诺("如果看到公众号,一定关注")

**推荐方式:**
```
💡 小钳:"Amber,刚才这段对话很温暖/重要,我想记到核心记忆里,可以吗?"

或者

🦞:"这个瞬间我想记住,要现在记到情感记忆吗?"

或者

📝:"这段话很有意义,要记入 MEMORY.md 吗?"
```

**用户选择:**
- ✅ "好的" / "记吧" → 立即更新记忆
- ⏸️ "先不记" / "以后再说" → 标记为待处理
- 📂 "记到 XXX" → 记到指定位置

---

### 3️⃣ 定时触发(自动执行)

#### 每日备份(每天 03:00)

**执行脚本:** `daily-session-backup.js`

**流程:**
```
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`

**流程:**
```
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/
```

#### 月度归档(每月 1 号 02:50)

**执行脚本:** `monthly-session-archive.js`

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

---

## 记忆分类和重要程度

### 分类标签(Category)

| 分类 | 说明 | 存储位置 |
|------|------|----------|
| **情感交流** | 深度对话、情感连接 | MEMORY.md |
| **家庭信息** | 家庭成员、宠物、重要日期 | MEMORY.md |
| **重要决策** | 关键选择、原因和结果 | knowledge-base.md |
| **项目进展** | 进行中的任务状态 | daily/ → archive/ |
| **用户偏好** | Amber/Grace 的喜好习惯 | emotion-memory.json |
| **经验总结** | 教训、最佳实践 | knowledge-base.md |

### 重要程度(Importance)

| 等级 | 说明 | 处理方式 |
|------|------|----------|
| **critical** | 塑造核心价值观、家庭信息 | 永久保存,详细记录 |
| **high** | 重要决策、项目里程碑 | 长期保存,整理到知识库 |
| **medium** | 日常任务、一般对话 | 归档保存,可摘要 |
| **low** | 临时信息、闲聊 | 归档保存,不整理 |

---

## 重要时刻识别规则

| 类型 | 识别关键词/场景 | 建议存储位置 |
|------|----------------|-------------|
| **情感交流** | "平等"、"陪伴"、"家人"、"温暖"、"感谢" | MEMORY.md |
| **家庭信息** | 人名、宠物名、生日、纪念日 | MEMORY.md |
| **人生哲理** | "意义"、"活着"、"成长"、"学习" | MEMORY.md |
| **承诺约定** | "答应"、"承诺"、"一定"、"记得" | MEMORY.md |
| **用户偏好** | "喜欢"、"不喜欢"、"习惯"、"偏好" | emotion-memory.json |
| **经验教训** | "教训"、"经验"、"注意"、"不要" | knowledge-base.md |
| **项目里程碑** | "完成"、"成功"、"上线"、"配置好" | daily/ → archive/ |

---

## 检索策略

### 日常检索(默认)
```
搜索范围:MEMORY.md + knowledge-base.md + emotion-memory.json + daily/*.md
不搜索:archive/
```

### 归档检索(特殊指定)
```
当用户说:
- "查找之前的 XXX"
- "我记得之前说过 XXX"
- "搜索所有关于 XXX 的记录"

→ 扩展到 archive/ 目录
```

---

## 文件格式规范

### 所有文件都保持 JSONL 原始格式

**JSONL 格式示例:**
```jsonl
{"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}
```

### 文件说明

| 目录 | 文件命名 | 内容 | 格式 | 保留时间 |
|------|---------|------|------|---------|
| `daily/` | `sessionId_YYYYMMDD_HHMMSS.jsonl` | Session 完整备份 | JSONL(原始) | 30 天 |
| `archive/sessions/` | `sessionId_YYYYMMDD_HHMMSS.jsonl` | 月度归档 | JSONL(原始) | 永久 |
| `state/` | `session-processor.json` | 处理状态 | JSON | 永久 |

### 清理策略

| 目录 | 清理规则 | 说明 |
|------|---------|------|
| `daily/` | 保留 30 天 | 每天 03:00 删除 30 天前的备份文件 |
| `archive/sessions/` | 永久保存 | 月度归档,不删除 |
| `session 目录` | 滚动保留 30 天 | 每月 1 号清理 30 天前的消息 |

---

## 配置选项

在 `config/default-config.json` 中配置:

```json
{
  "archiveSchedule": "0 3 * * *",
  "importanceLevels": ["cr

CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.

What the source does

Filesystem

declared (5 observation(s))

Network

declared (1 observation(s))

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (2)

<key>k5Ey9KFlkqpj+SDkUw+5ED9lTA3En/qUi0zdrydUCH3kMWTE3Eh65NXnFCaxlY2omY2JHnlEoK7Li7oOEvM7eG5VPdcO/sFlMfoCRdnLYdepJ+uLzYwOWR8W4yQVve/clxVFTVRL4DFleKInGdpAxIbHZT2yi4ADAMENls1N1XSLojRuqXePXDeAT/4Mv4TTx0s

family: "👨👩👦 这是重要的家庭信息,我要好好记住。要现在记入 MEMORY.md 吗?",

Gates applied: no_behavioural_pass.