Skip to content

v0.2.4 外部 review 七条修复

Choose a tag to compare

@yuannuo233 yuannuo233 released this 19 Nov 11:46
· 14 commits to main since this release

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 处硬编码全部改为 import
  • noGraph 改走 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 全绿。