🧠 Soul Memory System

智能記憶管理系統 v3.3.1 - 專為 AI Agent 設計的長期記憶框架

📦 快速安裝

一鍵安裝(推薦):

curl -sSL https://raw.githubusercontent.com/kingofqin2026/Soul-Memory-/main/install.sh | bash

手動安裝:

git clone https://github.com/kingofqin2026/Soul-Memory-.git
cd Soul-Memory-
python3 test_all_modules.py

✨ 核心功能

🏷️ 權重解析器

[C]/[I]/[N] 標籤解析 + 語義自動識別

🔍 向量搜索

關鍵詞索引 + 語義擴展搜索

📊 動態分類

自動學習類別 + Selection Rule

🔄 版本控制

Git 整合 + 版本回滾

⏰ 熱度衰減

時間衰減 + 訪問加權

⚡ 自動觸發

回答前自動搜索記憶

🗣️ 廣東話語法分支

語氣詞分級 + 語境映射 + 粵語檢測

🛡️ 雙軌持久化 (v3.3.1)

JSON 索引 + 每日備份 + 防覆蓋

💓 Heartbeat 自動儲存 (v3.3.1)

OpenClaw 整合 + 自動記憶檢查

🚀 快速開始

from soul_memory.core import SoulMemorySystem

# 初始化系統
system = SoulMemorySystem()
system.initialize()

# 搜索記憶
results = system.search("QST 暗物質", top_k=5)

# 添加記憶
system.add_memory("[C] 重要發現:...")

# 廣東話分析
result = system.analyze_cantonese("好啦好啦,算啦")

💓 v3.3.1 Heartbeat 主動提取

新功能:自動從對話中提取重要內容

自動執行(無需手動):

python3 /root/.openclaw/workspace/soul-memory/heartbeat-trigger.py

🤖 主動提取

自動讀取 session 對話
智能識別重要內容

🎯 智能分級

[C] Critical - QST/物理/公式
[I] Important - 劇情/長文本/定義
[N] Normal - 一般對話

🛡️ 防覆蓋機制

追加模式 (append-only)
防止 OpenClaw 會話覆蓋

✅ 三層保護

✓ 主動提取:Heartbeat 智能抓取
✓ 手動:對話中即時保存
✓ 自動:post_response_trigger()

📄 開源協議

Soul Memory System 採用 MIT License 開源協議。

您可以自由使用、修改、分發本軟體,唯一要求是保留版權聲明。

查看完整協議 GitHub 倉庫