Skip to content

v0.4.0 — namespace v4, backups, async jobs

Choose a tag to compare

@areCodeOI areCodeOI released this 08 Nov 19:56

海马体长期记忆 v0.4.0

新增

  • namespace v4 元数据与轻量策略:描述/颜色/只读/归档/保留天数/按空间自动召回;旧库从 meta.namespace_registry 自动迁移。
  • 逻辑备份/恢复:JSON 快照、原子写入、权限 600、保留份数;WebUI、CLI、HTTP 全入口。
  • 危险空间操作自动备份;恢复默认 dry-run,执行前再备份当前状态。
  • 异步 namespace rename/merge/delete job:进度、取消、事务回滚。
  • 只读 memory_namespace AI 工具(记忆工具 8 → 9)。
  • 按空间自动召回开关。

安全与可靠性

  • 备份/恢复仅限带 * 白名单的 admin;受限 key 一律 403。
  • 快照移入写事务并在事务内复核源/目标,避免备份后写入竞态。
  • 恢复拒绝损坏/过新/非普通文件/符号链接备份;有 queued/running 任务时拒绝。
  • 只读空间不再通过读取待删除记忆触发自动恢复。
  • 删除 namespace 会同步回收 API key 的空间白名单。

验证

  • GitHub Actions main CI:11/11 jobs 成功(Linux/Windows/macOS × Node 22/24、link、smoke、真实 PostgreSQL、Webapp、Playwright)。
  • PostgreSQL 集成:6 项检查通过(create/write、read-only、backup/restore、rename/merge、delete、v3→v4 迁移)。
  • 本地:107/107 单元集成、104/104 smoke、link 安装、Vitest、Playwright E2E。

升级

  • 直接升级到 0.4.0;旧数据库首次启动自动迁移到 schemaVersion 4。
  • 生产恢复前请先停止写入并等待/取消后台任务;备份文件含记忆明文,注意磁盘权限。
  • 完整变更见 CHANGELOG.md。