ai-memory SQLite迁移史50个版本Schema演进全梳理终极指南【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memoryai-memory 是一款为 AI 编码 CLI 提供长期记忆的开源项目它的核心存储是一张 SQLite 数据库而这张库的 Schema 至今已经演进到V63——从最初的 4 张表成长为一个覆盖多 Agent、多用户、向量检索、实体时间线与自动改进闭环的完整记忆系统。本文按阶段带你快速读完这段 ai-memory SQLite 迁移史看懂每个版本背后的设计动机。如果你正在评估 agent 记忆方案或者对「一个生产级 SQLite 库如何平滑迭代 60 次不翻车」感兴趣这篇文章会是一份省时间的路线图。第一阶段V01–V08奠基——记忆的核心四元组整个数据模型的基石在 V01__init.sql 中一次成型表职责workspaces/projects两级作用域所有数据行都挂在这棵树上pages记忆本体Markdown 页面支持版本链supersedessessions/observationsAgent 会话与原始观察事件links页面间的 wiki 链接图V01 里有个刻意的决定身份主键是(workspace_id, project_id, path)三元组并配了 FTS5 全文索引。紧随其后的几个版本各有所指V02__handoffs.sql新增handoffs表——这是 ai-memory 的招牌能力「跨 Agent 接力」。一个 Agent 会话结束时留下类型化的上下文快照摘要、未决问题、下一步下一个 Agent CLI 启动时认领实现 vendor 之间的无缝交接。V03__decay.sql引入遗忘机制在pages上加访问计数与软删除时间戳为「记忆衰减」提供数据。V04__embeddings.sqlpage_embeddings表落地向量检索向量直接打包为 BLOB 存库零外部依赖。V05–V08纯性能工程——级联删除索引、Wiki 层迁移记录表V06__wiki_migrations.sql、观察事件 FTSV07__observations_fts_and_link_index.sql和 FTS 触发器收窄。第二阶段V09–V13从 4 种 Agent 到「全家桶」早期sessions.agent_kind只允许 4 个值随着支持的 CLI 越来越多V09 用整表重建的方式扩开了 CHECK 约束SQLite 无法原地改约束这是本项目反复使用的标准手法。这一阶段还有两个值得新手学习的迁移V12__fts_remove_diacritics.sql换掉 FTS 分词器remove_diacritics 2让descricao也能命中descrição。因为分词器在 CREATE 时固定只能删表重建索引——而 FTS 表是 contentless 的源数据一行不动。V13__cross_project_links.sql链接支持[[project:path]]跨项目引用把各自为政的 Wiki 连成一张图。第三阶段V14–V20多用户归属与数据自愈这一阶段的主题是**「谁写了这条记忆」**V14__users.sql新增users表。注意注释里明确写着数据模型仍是单租户——没有 RBAC只做归属attribution。V15 / V16pages.author_id与audit_log.author_id审计日志记录「操作发生时」的作者而非页面当前作者保住时间点真相。V17把页面路径本身索引进 FTS搜 slug 也能命中。V18__enforce_project_workspace_pairing.sql用 BEFORE INSERT 触发器堵住「workspace 与 project 错配」的脑裂写入让陈旧写入直接失败而非静默污染。V19 / V27两次数据修复迁移把历史上被错误归入「碎片项目」的观察事件重新归位——Schema 演进中「修数据」和「加列」同样重要。V20为 Grok CLI 扩展 Agent 枚举从此每接入一个新 Agent 就是一个版本V25 Pi、V26 Zero、V28 Devin、V30 Kimi Code、V32 Crush、V44 Hermes、V45 Kiro CLI、V47 Command Code、V50 Pool、V51 ZCode……这个「一个 Agent 一个版本」的模式贯穿始终非常稳定且可回查。第四阶段V21–V34自动改进闭环与幂等摄取这是记忆系统从「存」走向「自我进化」的段落V21–V24auto_improve四连发——待审提案表、后台调度器、补丁式提案只改一小段而非整页、以及被拒提案的持久化缓冲区让系统记住「用户否决过什么」避免反复推荐。V29__maintenance_scheduler.sql全局维护作业节奏表。V31__managed_workstreams.sqlai-memory run托管工作流登场让多个 Agent 协作跑长任务。V33__ingest_keys.sqlHook 事件幂等键——重复投递的事件不会重复写入崩溃重放可安全续跑。V34__session_consolidation_jobs.sql会话结束后的 LLM 整合任务做成持久化工作队列异步消费、失败重试。第五阶段V35–V43精细化——水位、TTL、反馈与所有权V35用「观察数量水位」替代墙钟比较防止时钟漂移导致会话被反复重结。V36__page_expiry.sql页面级 TTL过期即隐藏并清删。V37检索质量显式反馈salience取代单一访问计数。V38__entities.sql实体索引成为与 FTS、向量、链接邻居并列的第四条检索流。V39–V43交接棒加 owner、会话加 owner、按操作者统计页面热度——共享服务器上的多人隔离逐层补齐。第六阶段V44–V632.0 时代——认证、时间线与证据V54__human_auth.sql / V55__api_credentials.sql人类登录密码/角色与原生 API 凭据分离旧 token 平滑迁移。V56–V58 / V62「双时间线」系列——实体链接与页面版本各自携带valid_from / valid_to摄取窗口支持as_of查询「某个时点的记忆长什么样」并回补修复了退役页面时间线窗口未关闭的缺陷。V57跨会话「经验蒸馏」pass 的调度状态落库。V52 / V59purge 墓碑表——删库删目录后客户端积压事件重放也不会「复活」已清除的数据。V60bootstrap 分块进度持久化崩溃续跑不重复烧 LLM 调用。V61__page_abstract_embeddings.sql摘要行独立嵌入成为第五路 RRF 检索流。V63__page_evidence.sql证据底表记录「哪些独立来源支撑了这个版本」为置信度信号铺路——这也是最新的一个版本。一张图看懂63 个版本全景版本区间主题关键词V01–V04奠基页面/会话/观察、交接、衰减、向量V05–V08性能级联索引、FTS 优化V09–V13Agent 扩展agent_kind 重建、无音调搜索、跨项目链接V14–V20多用户归属、审计、约束触发器、数据修复V21–V34自进化auto_improve 闭环、幂等键、整合队列V35–V43精细化水位、TTL、反馈、实体、所有权V44–V51Agent 持续扩展10 种新 Agent 逐个接入V52–V632.0 时代墓碑、认证、双时间线、证据给新手的 4 个工程启示只追加不破坏V07、V53、V63 等大量迁移是纯增量列/表旧数据零改写升级永远向前兼容。整表重建是 SQLite 的正规武器改约束、改主键V09、V13、V20……都走「建新表 → 拷数据 → 换名」的固定剧本且每次都在注释里提醒「保留全部现有索引与触发器」。迁移即文档每个 SQL 文件头部都用大段注释解释「为什么」migrations 目录本身就是一份可读的架构演进史。防呆设计migrations.rs 会把「数据库比二进制更新」的情况翻译成可读的DataSchemaAhead错误而不是抛底层库的晦涩报错。更多背景可参考项目文档ARCHITECTURE.md、MIGRATION-2.0.md、temporal.md 与 design-decisions.md。【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
