SuperAPI AI 工具集

bd-first-memory-migration

智能体与模型

查看项目

更新于 10-15 17:29

技能介绍

用途:把多个互不协调的智能体记忆库(如 Claude MEMORY.md、ao/flywheel 存储、.agents/learnings、bd memories)收敛到单一的 bd 权威底层,其余存储降级为派生缓存或退役。这不是通用去重工具,立场明确:bd 为准、用衰减排序召回替代 grep、低效用陈旧记忆被驱逐到冷存档而非静默删除。

适用与不适用:当存在 ≥2 个记忆库且有 bd(或准备采用 bd)、某存储停滞(例如 99% 停留在 provisional)、磁盘堆积大量重复摘录时使用;仅有一个健康存储、需要跨组织记忆联邦、或想保留每个库独立时跳过。

三个阶段:

  1. AUDIT 审计(只读):运行 scripts/audit-scan --target <box> 盘点各层,scripts/classify --manifest out/manifest.json 区分保留与废弃(干跑),产出 KEEP/DROP 清单与可逆性方案。⛔ 门禁 A:写入前由人工审阅清单。
  2. MIGRATE 迁移(仅写入 bd):scripts/import --manifest out/manifest.json --dry-run 后去掉 --dry-run;scripts/recall --query "<topic>" --max-tokens 400 为衰减排序召回;scripts/gen-memory-md 重新生成精简缓存。
  3. GC/RETIRE 回收与退役(破坏性):scripts/gc --dry-run 去重并驱逐到归档;⛔ 门禁 B 回滚测试通过后再执行退役;scripts/retire --dry-run 停用死守护进程并回收磁盘;⛔ 门禁 C 在真实机器上人工确认。

守卫措施:幂等、可逆、备份感知;每个破坏性步骤先备份并有文档化回滚;二、三阶段变更路径均提供可用的 --dry-run;批量抢救数千条记忆时须对 bd/Dolt 写入限速(写入间休眠、限制并发),否则会触发内存受限服务器 OOM。

限制:目标为 bd,不迁移追踪器本身;不做跨组织记忆联邦;不得在抢救验证前硬删存储,不得在回滚验证前执行破坏性退役,不得静默截断(需记录丢弃内容),不得手改生成的 MEMORY.md(它是只读缓存,应改 bd 记忆)。参考文档见 references 下的 PHASES、DATA-MODEL、ROLLBACK、EXAMPLES 及 audit.feature、migrate.feature。安装命令与更多细节未提供。