Zorv AI 记忆库架构全解析：端侧智能长期记忆系统设计

1. 项目简介项目Zorv AI包名com.ai.assistance.quro适用版本v1.0.77开源地址https://github.com/Quor-a/ZorvAIZorv AI 是一个端侧优先的 AI 助手项目其核心亮点之一便是记忆库Memory Library——一个文件化、AI 可自动沉淀的长期记忆系统。让 AI 能记住用户偏好 / 事实 / 约定 / 项目背景跨会话持续可用而不是每次对话都要用户重新交代。本文将从设计定位、整体架构、数据模型、检索引擎、AI 记忆工具等多个维度带你完整拆解这套记忆库的实现细节。2. 设计定位与核心特点Zorv AI 记忆库的设计遵循以下原则端侧优先纯本地 JSON 文件无云端依赖、无第三方库仅 Android 自带org.json。人格隔离每条记忆可绑定某张人格卡personaId空 全局记忆。AI 自动写通过memory_save等工具AI 在对话中主动沉淀记忆。可检索BM25 相关性排序 子串兜底中英混排友好。这套设计让记忆库既能保证用户隐私数据不出端又能提供足够灵活的检索能力兼顾性能与召回率。3. 整体架构记忆库整体分为四层AI 引擎、工具层、仓库层与持久化层。持久化仓库层 (QuroMemoryRepository)AI 引擎工具层 (QuroMemoryTools)QuroMemorySaveToolQuroMemoryListToolQuroMemorySearchToolQuroMemoryDeleteToolmemory_save / memory_listmemory_search / memory_deleteloadAll / loadForPersonaadd / update / deletesearch (BM25)saveAll (JSON 文件)filesDir/quro_memory.jsonAI 引擎通过 function calling 调用记忆工具。工具层封装 4 个记忆操作工具。仓库层核心业务逻辑负责加载、增删改查与检索。持久化最终落盘为本地 JSON 文件。4. 数据模型QuroMemoryEntry每条记忆的数据结构如下字段类型说明idStringUUID唯一标识personaIdString绑定人格卡 id空 全局记忆groupString分组 / 文件夹偏好 / 工作 / 项目titleString标题便于检索与展示contentString记忆正文必填tagsListString命名关联标签createdAtLong创建时间updatedAtLong更新时间人格隔离机制loadForPersona(A)全局记忆personaId记忆库人格 A 记忆人格 B 记忆A 的记忆 全局记忆loadForPersona(id)某人格卡取记忆时自动并入全局记忆personaId为空者实现人格专属 全局共享。5. 存储与持久化文件位置context.filesDir / quro_memory.json格式{memories:[ ... ]}纯JSONObject/JSONArray无第三方依赖。向后兼容仅含id/personaId/content/tags/createdAt的历史文件可正常加载。{memories:[{id:uuid-...,personaId:,group:偏好,title:不喝咖啡因,content:用户下午后不喝含咖啡因饮品,tags:[习惯,健康],createdAt:1234567890,updatedAt:1234567890}]}6. 检索引擎BM25 子串兜底检索策略采用双层保障确保相关性与召回率兼顾。核心源码位于QuroMemoryRepository.search()。topK 全量是否query1) BM25 打分排序相关结果降序BM25 是否漏掉子串命中?2) 子串包含兜底(内容/标题/标签/分组)直接返回最终结果 相关排序 兜底追加层机制收益BM25词频饱和 长度归一化中文走 bigram无需词典短而切题的记忆排在长而泛泛之前支持中英混排/多词子串兜底对纯符号/单字符/分词边界特殊查询补召回不丢失精确编号/英文片段的旧行为索引文本 标题 内容 标签 分组任一字段命中即得分。空查询返回全部记忆。7. AI 记忆工具function callingAI 通过 4 个工具直接与记忆库交互见QuroMemoryTools.kt工具名作用关键参数memory_save保存一条长期记忆content(必填) /title/group/tagsmemory_list列出全部记忆无memory_search按关键词检索querymemory_delete删除匹配的记忆query自动沉淀原则当用户透露值得跨会话记住的信息偏好/约定/项目背景时AI应主动调用memory_save无需用户明确要求。8. 与灵魂注入的衔接记忆库是灵魂层的三大输入之一为 AI 人格提供长期记忆上下文loadForPersona第三优先级关闭开启记忆库QuroMemoryRepositorySoulContext.memoriesQuroSoulPromptEngine灵魂层提示词『已有记忆』段autoSaveMemory 开关不注入记忆 / 不提示记忆能力受AI 自动保存记忆开关autoSaveMemory控制关闭时既不注入已有记忆也不提示记忆能力。注入时以自然融入对话不要生硬提及的方式呈现维持人格一致性。9. 并发安全与导入导出机制实现进程级写锁companion object writeLock跨ViewModel / 语音球 / 记忆工具多实例保证临界区原子杜绝并发写互相覆盖临界区 reloadadd/update/delete/mergeImport在锁内重新loadAll()再写避免同窗口覆盖导出exportJson()→{memories:[...]}文本导入mergeImport()按id合并相同 id 覆盖否则追加返回导入条数兼容解析parseJson()兼容{memories:[...]}与纯数组两种格式10. 能力对照表能力入口说明保存记忆memory_saveAI 主动沉淀列出记忆memory_list全量展示检索记忆memory_searchBM25 子串兜底删除记忆memory_delete按关键词匹配人格隔离personaId专属 全局共享导入导出mergeImport/exportJson备份与迁移并发安全writeLock跨实例原子写11. 总结Zorv AI 的记忆库设计体现了几个值得借鉴的思路端侧优先数据不出端天然保护隐私也省去云端同步的复杂度。AI 自动沉淀通过 function calling 让 AI 主动记忆而非依赖用户手动操作。双层检索BM25 保证相关性子串兜底保证召回率兼顾精度与覆盖。人格隔离personaId实现专属 全局共享的灵活记忆边界。并发安全进程级写锁 临界区 reload保证多实例写入不互相覆盖。如果你对端侧 AI 记忆系统、function calling 落地或 Android 本地持久化方案感兴趣这个开源项目值得深入阅读源码。开源地址https://github.com/Quor-a/ZorvAI配套文档跨进程能力框架见《ACI 完整架构介绍》系统级浮窗见《LSPosed 与系统级浮窗技术架构》小程序渲染见《小程序技术架构》人格与心跳见《灵魂注入与 AI 心跳人格自动孵化》。