#heyq02/moomem

MoonBit 嵌入式 Agent 记忆层 —— 零部署、崩溃可恢复、按用户结构隔离。

#核心能力

• 两行接入 — MemoryStore::open + add / recall；聚合根仅 6 个公开方法
• 默认零 API Key — 嵌入 / 提取 / 冲突均为可注入 trait，缺省离线确定性实现
• 混合检索 — 向量 + BM25；缺省查询自适应融合（AdaptiveLexical，可回退等权 RRF）；索引按 user_id 物理分片
• 崩溃安全持久化 — 双槽 JSONL 快照 + head 指针
• 结构级用户隔离 — 检索强制带 user_id，无全库召回接口
• 可选 LLM 路径 — src/llm_extractor 对接 OpenAI 兼容端点（核心包零 LLM 依赖）

#相对竞品 / 生态

#证据

• Benchmark 站内页 — 发版归档的 LoCoMo L3 分数
• LoCoMo 评测报告 — 提取 / 冲突 / 持久化 / 隔离 / 检索归因

#最短上手

moon add heyq02/moomem

fn main {
  let mem = @moomem.MemoryStore::open("./memory").unwrap()

  let summary = mem.add("user-42", "我对花生过敏").unwrap()
  println("extracted=\{summary.extracted} inserted=\{summary.inserted}")

  let hits = mem.recall("user-42", "花生过敏", top_k=3).unwrap()
  for e in hits {
    println("[\{e.created_at}] \{e.content}")
  }

  ignore(mem.close())
}

#文档