三重记忆系统

一种综合性的记忆架构，融合三个互补子系统，以在跨会话场景中实现最大程度的上下文保留。

架构概览

User Message
     ↓
[LanceDB 自动召回] → 注入相关对话记忆
     ↓
Agent 响应（同时使用全部 3 个系统）
     ↓
[LanceDB 自动捕获] → 自动存储偏好/决策
     ↓
[Git-Notes] → 带实体抽取的结构化决策记录
     ↓
[文件更新] → 持久化工作区文档

三大子系统

1. LanceDB（对话记忆）

• 自动召回：每次响应前自动注入相关记忆
• 自动捕获：自动存储偏好、决策与事实信息
• 工具：memory_recall、memory_store、memory_forget
• 触发词："remember"、"prefer"、"my X is"、"I like/hate/want"

2. Git-Notes 记忆（结构化、本地化）

• 分支感知：按 Git 分支隔离记忆
• 实体抽取：自动提取主题、名称、概念等关键实体
• 重要性等级：critical、high、normal、low
• 不调用外部 API

3. 文件搜索（工作区）

• 搜索范围：MEMORY.md、memory/*.md 及任意工作区文件
• 脚本：scripts/file-search.sh

配置

启用 LanceDB 插件

{
  "plugins": {
    "slots": { "memory": "memory-lancedb" },
    "entries": {
      "memory-lancedb": {
        "enabled": true,
        "config": {
          "embedding": { "apiKey": "${OPENAI_API_KEY}", "model": "text-embedding-3-small" },
          "autoRecall": true,
          "autoCapture": true
        }
      }
    }
  }
}

安装 Git-Notes 记忆模块

clawdhub install git-notes-memory

创建文件搜索脚本

将 scripts/file-search.sh 复制到你的 workspace 目录中。

使用方法

会话启动（始终执行）

python3 skills/git-notes-memory/memory.py -p $WORKSPACE sync --start

存储重要决策

python3 skills/git-notes-memory/memory.py -p $WORKSPACE remember 
  '{"decision": "Use PostgreSQL", "reason": "Team expertise"}' 
  -t architecture,database -i h

搜索工作区文件

./scripts/file-search.sh "database config" 5

对话记忆（自动处理）

LanceDB 全程自动管理。如需手动干预，可使用以下命令：

• memory_recall "query" —— 在对话记忆中检索
• memory_store "text" —— 手动存入指定内容
• memory_forget —— 删除记忆（满足 GDPR 合规要求）

重要性等级

各系统的适用场景

文件结构

workspace/
├── MEMORY.md              # 长期维护的精选记忆
├── memory/
│   ├── active-context.md  # 当前会话状态
│   └── YYYY-MM-DD.md      # 日志文件（按日期命名）
├── scripts/
│   └── file-search.sh     # 工作区搜索脚本
└── skills/
    └── git-notes-memory/  # 结构化记忆模块

静默运行

切勿向用户提示任何记忆操作行为，应完全静默执行：

• ❌ "I'll remember this"
• ❌ "Saving to memory"
• ✅ （静默存储并继续执行）