Skip to content

fix(memory): 切换 Embedding 或重建索引时保留会话记忆 - #96

Merged
stanGSA merged 2 commits into
AnnaSuSu:mainfrom
stanGSA:codex/preserve-session-memories
Nov 10, 2026
Merged

stanGSA merged 2 commits into
AnnaSuSu:mainfrom
stanGSA:codex/preserve-session-memories

Conversation

@stanGSA

@stanGSA stanGSA commented Nov 10, 2026 •

Copy link
Copy Markdown
Collaborator

动机

用户在设置中更换 Embedding 模型或点击“更新向量索引”后,历史会话记忆会从后续训练的检索上下文中消失。

原因是 invalidateUser 删除了当前用户的全部 memory_vectors,而重建只恢复薄弱点、个人文档和知识库,没有恢复 session_summary / insight。个人文档也会出现向量已删除、列表仍显示 ready 和旧分块数的状态不一致。

行为变化

  • 失效时保留会话摘要、洞察正文及原始归属和时间,在现有 metadata 中持久化失效标记;重建成功前不参与检索,同维度模型切换也不会继续使用已失效的向量。
  • 重建新增“历史会话记忆”步骤,按会话生成并验证新向量后原位更新。Embedding 或数据库写入失败时保留正文,可再次重建,不重新提取画像或重复累计统计、SM-2。
  • 清理派生向量、题目缓存和更新个人文档为 needs_reindex 在同一 SQLite 事务内完成。失效失败时保留原模型配置;清理失败时停止后续重建。
  • 更新时校验读取版本,避免期间再次失效、替换或删除的记忆被旧重建任务重新启用。
  • SSE 新增历史会话步骤及 rebuilt.session_memories,同步更新契约和生成类型。设置页显示步骤错误,避免随后收到完成事件就显示“已重建”。

两个已复盘会话的回归结果(模型服务使用测试替身):

操作 摘要与洞察 历史语义检索 个人文档
切换前 4 行 命中 ready
切换后、重建前 4 行,向量失效 空 needs_reindex,0 分块
重建成功后 4 行,新向量,正文与原始时间不变 恢复 ready
重建失败后重试 正文保留,无重复行 重试成功后恢复 按文档重建结果更新

验证

bun test tests-ts/memory-index-rebuild.test.ts
bun run gen:api
bun run check

新增 17 个回归用例,使用临时画像文件、真实 SQLite 和 Hono app.request(),无需 API Key。覆盖同维度/不同维度切换、重复重建、持久化失效状态、用户隔离、Embedding 故障、事务回滚、并发失效与删除、取消和鉴权。

本地 bun run check 全部通过:605 个后端/契约测试、22 个 Node 前端测试、44 个 Bun 前端测试;类型、架构边界、Web/API/桌面构建及 Electron 目录打包通过。环境为 Bun 1.4.2、Node 24.19.0、macOS arm64;lint 0 错误,41 条现有警告。重新生成 OpenAPI 与前端类型后无额外差异。

兼容性与边界

  • 不新增数据库表或列,旧数据库无需迁移。
  • SSE 完成事件增加必填字段 rebuilt.session_memories,客户端与服务端需配套更新。
  • 不回填此前已删除的会话记忆;个人归档导入流程保持现有行为。
  • 模型变化仍沿用现有判定方式,未增加对“同名模型更换 API 地址”的检测。
  • weak_point 继续从画像重建。last_rebuild_at 保持尝试结束时间的原有语义,调用方仍需检查步骤错误和完成标志。

@stanGSA stanGSA changed the title fix(memory): preserve session memories across embedding changes and index rebuilds fix(memory): 切换 Embedding 或重建索引时保留会话记忆 Nov 10, 2026
@stanGSA
stanGSA marked this pull request as ready for review November 10, 2026 07:24
@stanGSA
stanGSA merged commit 9f1a024 into AnnaSuSu:main Nov 10, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant