Session Memory Enhanced

Session-Memory Enhanced v4.0

融合 session-memory + memu-engine 的统一增强版记忆管理。

🎯 核心特性

memu-engine 优势：结构化提取、向量检索、多代理隔离、去重机制 session-memory 优势：不可变分片（Token节省90%+）、三位一体（记忆+QMD+Git）、AI摘要、零配置

🚀 使用方式

# 安装
cd skills/session-memory-enhanced
cp config/unified.json.example config/unified.json

# 自动模式（crontab）
0 * * * * $(pwd)/skills/session-memory-enhanced/scripts/session-memory-enhanced.sh

# 手动执行
bash scripts/session-memory-enhanced.sh

# 语义检索
python3 python/searcher.py --query "关键词" --db memory/agents/main/vectors.db

🔧 配置（unified.json）

{
  "version": "4.0.0",
  "flushIdleSeconds": 1800,
  "maxMessagesPerPart": 60,
  "features": {
    "structuredExtraction": false,
    "vectorSearch": false,
    "aiSummary": true,
    "gitBackup": true,
    "qmdUpdate": true
  }
}

📁 文件结构

session-memory-enhanced/
├── scripts/session-memory-enhanced.sh  # 主脚本
├── python/extractor.py, embedder.py, searcher.py
├── config/unified.json
└── docs/

📖 分层读取策略（⚠️ 重要 - Token节省核心）

🚫 禁止全量读取 MEMORY.md（16KB+）

绝对禁止在任何场景下直接 read MEMORY.md 全量读取。这是最大的Token浪费源。

分层规则

操作指南

# ✅ 正确：精准检索
memory_search("用户偏好")
memory_search("项目决策")

# ✅ 正确：按需读取特定段落
memory_get(path="MEMORY.md", from=100, lines=50)

# ✅ 正确：启动时只读精简版
read MEMORY-LITE.md

# ❌ 禁止：全量读取
read MEMORY.md  # 绝对禁止！

MEMORY-LITE.md 维护（v4.2.1 更新）

• MEMORY-LITE.md 是唯一允许全量读取的记忆文件
• 必须控制在 5KB 以内（当前 ~2.2KB）
• 由定时脚本自动从 MEMORY.md 精华摘要生成
• 内容：核心偏好、关键决策、重要约束
• flush 去重：写入前检查是否已有相同 timestamp 条目，避免重复

⚙️ 环境变量

• OPENAI_API_KEY：向量嵌入和AI摘要（不提供时降级为纯文本模式）

详细功能对比、安装步骤、Python集成指南见 references/skill-details.md

📄 许可证与版权声明

MIT License

Copyright (c) 2026 思捷娅科技 (SJYKJ)

免费使用、修改和重新分发时，需注明出处。

出处：

• GitHub: https://github.com/example-user/openclaw-skills
• ClawHub: https://clawhub.com
• 创建者：思捷娅科技 (SJYKJ)/zhaog100

商业使用授权：

• 个人/开源：免费
• 小微企业（<10 人）：¥999/年
• 中型企业（10-50 人）：¥4,999/年
• 大型企业（>50 人）：¥19,999/年
• 源码买断：¥99,999 一次性

详情请查看：LICENSE