记忆系统指南

# 记忆系统指南

> **版本**: v2.0.0 | **更新日期**: 2026-03-10 | **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组

---

## &#129504; 记忆系统架构

当前项目使用 **SQLite + 向量搜索** 的记忆系统：

```
┌─────────────────────────────────────────────┐
│  项目记忆加载器 (project-memory-loader)      │
│  docs/skills/project-memory-loader/SKILL.md │
└─────────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────────┐
│  SQLite 数据库                               │
│  data/memories.db (23MB)                    │
│  - 结构化记忆存储                            │
│  - 向量嵌入支持                              │
└─────────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────────┐
│  项目摘要                                    │
│  docs/压缩摘要.md                            │
│  - 项目概览、红线规则、核心信息              │
└─────────────────────────────────────────────┘
```

---

## &#127919; 标准工作流程

### 每次对话开始时（自动触发）

```
project-memory-loader 自动加载
    ↓
加载项目上下文
    ├── 项目概览
    ├── 分区表架构
    ├── 红线规则
    ├── TODO 列表
    └── 高优先级信息
    ↓
输出项目状态概览
    ↓
准备接收用户指令
```

### 手动加载记忆

```bash
# 读取项目摘要
cat /workspace/projects/压缩摘要.md

# 调用记忆 API
curl http://localhost:5000/api/project-memory/context
```

---

## &#128188; 使用场景

### 场景1：快速查找项目信息

```bash
# 读取项目摘要
cat /workspace/projects/压缩摘要.md

# 搜索知识库
curl -X POST http://localhost:5000/api/ai-memory/search \
  -H 'Content-Type: application/json' \
  -d '{"query": "分区表", "topK": 5}'
```

### 场景2：更新项目记忆

```bash
# 自动记忆（提交后自动触发）
git commit -m "feat: 新功能"

# 手动同步
pnpm memory:sync
```

### 场景3：知识库管理

```bash
# 导入文档到知识库
pnpm kb:import

# 搜索知识库
pnpm kb:search "关键词"
```

---

## &#128221; 记忆维护指南

### 自动更新（Git Hook）

每次 `git commit` 后，post-commit hook 自动：
1. 记录提交到记忆系统
2. 同步到向量知识库
3. 累积待发布内容

### 手动更新时机

**必须更新** ✅：
- 发现新的已知问题
- 完成待办事项
- 重要技术决策

**操作**：
```bash
# 同步记忆
pnpm memory:sync

# 更新项目摘要
编辑 docs/压缩摘要.md
```

---

## &#128736;️ 常用命令

```bash
# 记忆同步
pnpm memory:sync

# 记忆备份
pnpm memory:backup

# 知识库导入
pnpm kb:import

# 知识库搜索
pnpm kb:search "关键词"

# 红线检测
pnpm redline:check
```

---

## &#128193; 相关文件

| 文件 | 说明 |
|------|------|
| `data/memories.db` | SQLite 记忆数据库 |
| `docs/压缩摘要.md` | 项目核心摘要 |
| `docs/skills/project-memory-loader/SKILL.md` | 记忆加载器配置 |
| `PROJECT.md` | 项目说明文件 |

---

## &#128279; 相关文档

- [智能进化](../19-智能进化/) - AI 进化机制
- [自动化实现总览](../19-智能进化/自动化实现总览.md) - Git Hooks 自动化