Repository navigation
v0.2.2 向量检索 + 图检索
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)。