Repository navigation
v0.2.4 外部 review 七条修复
Membrane v0.2.4
外部 review 对 main 做了全量静态审查,指出 7 条问题。逐条复现后确认全部属实,本版全部修复。
⚠️ 三处破坏性变更
| 变更 | 影响 |
|---|---|
公开 API containment → tokenOverlap |
直接 import 该函数的代码需要改名 |
冲突判定 |A∩B|/min → |A∩B|/max |
短记忆不再以 1.0 相似度取代完整事实 |
REST /api/recall 默认 full → brief |
不传 detail 的调用方字段变少(省 token) |
公式变化的影响举例:"北京市" 对 "用户住在北京市海淀区" 从 1.0 降到约 0.22,不再误取代完整事实;同长度换地名仍保持 0.6,可正常取代。
P0 修复
1. 配 token 后 Web 控制台打不开
静态页与 /api/* 分离鉴权,控制台首屏不再被 401 拦。支持 Authorization: Bearer 与 ?token=;浏览器用 ?token= 打开后存 localStorage 并从地址栏抹掉。补 OPTIONS 204 预检与 CORS 头。
2. 中文标点把分词劈成两半
。 , 《》 曾进入 bigram 并切断连续文本。现在分词前统一剥离标点。
3. 短记忆误杀长记忆
见上方公式变更。
P1 / P2 修复
- CLI 布尔 flag 不再吞下一个位置参数
src/version.ts成为版本唯一事实源,4 处硬编码全部改为 importnoGraph改走asBoolean,字符串"true"生效- 导入校验:
normalizeImportRecord校验 kind/confidence/时间戳/namespace/tags;向量含 NaN/Infinity/字符串时整条跳过
安装
尚未发布到 npm。
git clone https://github.com/yuannuo233/membrane-memory.git
cd membrane-memory && npm install && npm test && npm run build
node dist/cli.js doctor
或下载下方 tgz。需要 Node ≥ 24。
测试:221 个(16 个文件),CI 全绿。