# remem 项目规则

## 核心目标

remem 的目标是做**最强**的 Codex 记忆系统，不是最便宜的。

所有设计决策的判断标准只有一个：**记忆质量是否提升**。成本、延迟、依赖复杂度都是次要的。

## 已犯错误（必须避免重复）

### 错误 1：Zero-LLM 方向错误

2026-03-15 的重构（commit fd7159c）把方向搞反了——砍掉了 LLM 提取能力以"节省成本"，实际上是在削弱记忆质量。调研 10+ 竞品（Mem0/Zep/Letta/Engram/LangMem）的目的是**吸收最强设计**，不是证明可以砍掉 LLM。

### 错误 2：save_memory 不会被调用

设计了 save_memory MCP 工具让 Codex "主动保存"记忆，但 Codex 实际上不会主动调用这个工具。结果是：
- **自动捕获被砍了**（原来的 LLM 提取删了）
- **手动保存不会发生**（Codex 不会主动调 save_memory）
- **记忆变成空的** — 两个通道都断了

这是致命的设计缺陷：不能依赖 Codex 的"自觉性"来保存记忆。

### 教训

1. **不要为了省成本砍功能** — 用户不在乎成本，在乎质量
2. **不要依赖 Codex 主动调用** — 自动化捕获是主力，手动保存只是补充
3. **先把基础做好** — 记忆存储本身不行，加再多高科技（向量搜索、知识图谱）也没用
4. **调研是为了取长** — 竞品分析的结论应该是"我们要加什么"，不是"我们可以砍什么"

## 构建和测试

```bash
cargo check        # 编译检查
cargo test         # 运行测试
cargo build --release  # 发布构建
```
