Memory Orchestrator - 全栈智能记忆系统

# Memory Orchestrator - 全栈智能记忆系统

> **让 AI 拥有长期记忆、情感感知和自我进化能力的终极技能**

🍬 **一句话介绍**：这不是一个简单的记忆插件，而是一个**会思考、有温度、能进化**的完整记忆生态。从语义搜索到多模态理解，从知识图谱到情感分析，再到自进化引擎，一键部署，全自动维护。

---

🚀 核心功能

| 功能模块 | 技术栈 | 描述 |

|----------|--------|------|

| **🧠 语义搜索** | FAISS + `all-MiniLM-L6-v2` + `qwen2.5:7b` | 自然语言检索记忆，支持模糊查询、上下文关联。 |

| **🔄 自动化同步** | Syncthing (P2P) + Git + git-crypt | 跨设备实时同步，敏感文件端到端加密，离线优先。 |

| **📸 多模态理解** | CLIP (图像) + Whisper (音频) | 图片/音频自动转文本并生成嵌入，加入索引。 |

| **🕸️ 知识图谱** | NetworkX + `pyvis` + 关系抽取 | 自动提取实体和关系，生成交互式可视化图谱。 |

| **❤️ 情感标记** | `qwen2.5` 零样本分类 | 自动标注情绪（#兴奋, #挫折, #启发）和价值评分（1-5）。 |

| **🦠 自进化引擎** | 自定义评分算法 + A/B 测试 | 自动优化检索策略，归档低价值记忆，持续自我提升。 |

| **🤖 主动推荐** | 触发器引擎 (关键词/时间/场景) | 根据上下文主动推送相关历史记忆。 |

---

📦 安装指南

方式一：通过 `iflow` 一键安装 (推荐)

iflow skill install memory-orchestrator

方式二：手动安装

# 1. 克隆技能目录
git clone https://github.com/openclaw/clawhub.git
cd clawhub/skills/memory-orchestrator

# 2. 运行安装脚本
bash install.sh

# 3. 启动服务
systemctl start syncthing@claw
ollama serve  # 确保 qwen2.5:7b 已安装

依赖检查

安装脚本会自动检查并安装以下依赖：

---

🛠️ 使用示例

1. 语义搜索

# 搜索特定主题
memory_search "上次解决 Git 冲突的方法"

# 按情感过滤
memory_search --emotion "#启发" --min-score 4

# 按价值排序
memory_search --sort-by score

2. 多模态处理

# 处理图片
memory_multimodal process screenshot.png
# 输出：自动提取特征、生成描述、加入索引

# 处理音频
memory_multimodal process meeting_recording.mp3
# 输出：Whisper 转录、生成嵌入、加入索引

3. 知识图谱

# 生成图谱
memory_knowledge_graph generate

# 打开交互式 HTML
xdg-open docs/output/knowledge_graph.html

4. 情感分析 & 自进化

# 批量标注情感
memory_evolve tag-emotions

# 运行自进化优化
memory_evolve run

# 查看优化报告
cat docs/output/evolution_optimization_report.md

5. 主动推荐

# 手动触发推荐
memory_recommend --context "新项目启动"

# 自动推荐 (由 iflow 钩子自动触发)
# 会话启动时自动推送相关记忆

---

🏗️ 架构设计

graph TD
    A[用户输入] --> B{iflow 工作流}
    B --> C[Pre-session Hook]
    C --> D[拉取最新记忆 + 重建索引]
    D --> E[主动推荐引擎]
    E --> F[AI 对话]
    F --> G[Post-session Hook]
    G --> H[提取新记忆 + 情感标注]
    H --> I[知识图谱更新]
    I --> J[自进化优化]
    J --> K[FAISS 索引更新]
    K --> L[Syncthing/Git 同步]
    L --> M[跨设备备份]
    
    N[多模态输入] --> O[CLIP/Whisper]
    O --> P[文本描述 + 嵌入]
    P --> K
    
    Q[手动命令] --> R[memory_search / memory_knowledge_graph / memory_evolve]
    R --> K

---

📂 文件结构

memory-orchestrator/
├── SKILL.md                 # 本文件
├── README.md                # 简化版说明
├── install.sh               # 一键安装脚本
├── run.sh                   # 启动脚本
├── requirements.txt         # Python 依赖
├── scripts/
│   ├── memory_search.py     # 语义搜索
│   ├── multimodal_processor.py # 多模态处理
│   ├── knowledge_graph_builder.py # 知识图谱
│   ├── emotion_tagger.py    # 情感标注
│   ├── self_evolution_engine.py # 自进化
│   └── auto-commit-memory.sh # 自动同步
├── workflows/
│   ├── memory-sync.yaml     # 同步工作流
│   ├── memory-multimodal.yaml # 多模态工作流
│   └── memory-emotion-evolve.yaml # 情感进化工作流
├── hooks/
│   ├── pre-session.sh       # 会话前钩子
│   └── post-session.sh      # 会话后钩子
└── docs/
    ├── architecture.md      # 架构详解
    └── usage-guide.md       # 详细使用指南

---

🎯 适用场景

---

🚧 未来规划

---

📞 支持与反馈

---

**让记忆不再只是存储，而是成为你的第二大脑！** 🧠✨