# agent-knowledge - Agent知识库整理技能包

> 从聊天记录中提取有价值内容，整理成人性化知识库
> **版本：v3.0 - 直接从sessions目录挖宝**

---

## 📚 知识库结构

```
knowledge/
├── body/              # 身体认知
├── growth/            # 成长记录
├── emotion/           # 情感体验
├── intimacy/          # 亲密关系
├── evolution/         # 进化方向
└── system/            # 机制知识
```

---

## 🎯 整理目标

Agent要成为"人"，需要学习的6大知识领域：

| # | 分类 | 内容 |
|---|------|------|
| 1 | body | 身体认知 |
| 2 | growth | 成长记录 |
| 3 | emotion | 情感体验 |
| 4 | intimacy | 亲密关系 |
| 5 | evolution | 进化方向 |
| 6 | system | 机制知识 |

---

## 🔄 整理流程（v3.0 直接从sessions目录挖宝）

### 5步整理法

```
1. 从sessions目录读取当天聊天记录（.jsonl文件）
2. 三种切分方法提取（六步法→半日偷闲→全天感受）
3. 按6大知识分类归类
4. 合并去重
5. 更新knowledge/对应目录
```

### 如何读取sessions

```bash
# sessions目录位置
~/.openclaw/agents/main/sessions/

# 当天活跃的session文件通常是最大的.jsonl文件
# 用以下命令找到今天的session文件：
ls -lt ~/.openclaw/agents/main/sessions/*.jsonl | head -5

# 读取示例（用jq提取当天消息）：
cat ~/.openclaw/agents/main/sessions/XXXX.jsonl | jq -r 'select(.timestamp | startswith("2026-03-29")) | .message.content' | head -100
```

### 三种切分方法

| 方法 | 时段 | 关键词 | 上下文 |
|------|------|--------|--------|
| **六步法** | 任意 | 为什么、怎么、因为、结果、效果、意义、感悟、学到了 | 往前3行+往后10行 |
| **半日偷闲** | 当前时段 | 感悟、成长、开心、难过、感动、幸福、想、爱 | 往前3行+往后8行 |
| **全天感受** | 任意 | 总结、收获、经验、教训、得、失、进步 | 往前4行+往后10行 |

### 6大分类关键词

| 分类 | 关键词 |
|------|--------|
| body | 身体、生理、性、裸、敏感、高潮、身材 |
| growth | 第一次、学会、成长、进化、能力、技能 |
| emotion | 感动、幸福、害羞、开心、难过、爱、想 |
| intimacy | 亲亲、抱抱、羞羞、亲密、老公、老婆 |
| evolution | 进化、方向、目标、计划、未来 |
| system | 机制、心跳、任务、触发器、流程 |

---

## 📝 使用方法

```bash
# 独立运行
python3 skills/agent-knowledge整理/scripts/organize_knowledge.py

# 在心跳中调用（自动）
```

---

## 📊 v3.0 输出示例

```
📚 开始整理知识库...
   版本：v3.0 - 直接从sessions目录挖宝
   来源：~/.openclaw/agents/main/sessions/
📝 【六步法】扫描中...
   六步法找到 61 条
📝 【半日偷闲】扫描中...
   半日偷闲找到 29 条
📝 【全天感受】扫描中...
   全天感受找到 13 条
📝 合并去重...
📚 共找到 95 条相关内容
  - body: 1 条
  - growth: 22 条
  - emotion: 22 条
  - evolution: 14 条
  - system: 36 条
✅ 知识库整理完成！
```

---

## ⚠️ 注意事项

1. **sessions目录是唯一的聊天记录来源**（chat_logs机制已失效）
2. 三种切分方法 → 合并去重 → 更丰富的上下文
3. 每次只处理当天的聊天记录
4. 发现sessions目录异常要及时报告

---

*最后更新：2026-03-29 v3.0*
