Skip to content

v0.2.2 向量检索 + 图检索

Choose a tag to compare

@yuannuo233 yuannuo233 released this 19 Nov 08:44
· 19 commits to main since this release

Membrane v0.2.2

Temporal-aware, local-first, explainable memory engine for AI agents.
Zero runtime dependencies (only ulid), single SQLite file, works fully offline.

本版核心更新

向量检索从"只留接口"变成真能用

  • add({vec}) 写入时同事务落库;addAsync 自动调 /embeddings;backfillEmbeddings 回填老库
  • 分批扫描(keyset,默认 512/批),内存占用不随库膨胀
  • 维度守卫:混用两套 embedding 模型时跳过并提示,绝不阻断写入;算向量失败也不丢记忆

图检索从零实现

  • entities / relations / memory_entities 三表,schema 1→2 加法式迁移,老库不丢数据
  • 唯一键用 (namespace, name) 而非 (namespace, name, type),避免同名实体被劈成两个节点
  • 手动标注优先;否则按 6 类中文句式抽取,宁缺毋滥
  • relations(a, b?, {maxHops, asOf}):一跳邻居 / 两跳路径 / 整句自动认实体
  • 关系跟随记忆取代与遗忘关闭 valid_to(不删行,asOf 仍可查)

记忆可编辑

  • engine.update/updateAsync:版本化编辑,新版本取代旧版本,历史/证据/关系保留

控制台重做

  • 三模式 + 运维日志与诊断后台

安装

尚未发布到 npm。两种方式:

从源码构建(推荐,能顺带验证测试)

git clone https://github.com/yuannuo233/membrane-memory.git
cd membrane-memory
npm install
npm test          # 应显示 212 passed
npm run build
node dist/cli.js doctor

或下载下方 tgz

npm install -g ./membrane-memory-0.2.2.tgz

需要 Node ≥ 24(node:sqlite 在 22/23 需 flag,24 起默认启用)。

已知局限

无同义词检索(需自算 embedding)、只验证过中英文分词、无真实用户验证。
完整清单见 README 的「已知局限」。

可复现自检

node dist/cli.js doctor

测试:212 个,CI 全绿(Ubuntu + Windows × Node 24/25)。