AI Agent人工智能大模型AI 应用工具调用本地部署MCP ClientsAgent 记忆【免费下载链接】OperitThe most powerful AI agent and AI chat software on Android/Operit是一款Android上能力最为强大、发展最久的AI Agent项目地址https://gitcode.com/gh_mirrors/op/Operit点击查看免费下载导读本文以 memory_space_profile_documents 系列设计文档为主线系统讲解 OperitAndroid 端 AI Agent 应用如何把 Release 1.12.05 时代的单一全局私有user.md演进为每个记忆空间memory space独占一份user.md的完整方案。你将掌握档案文档的磁盘存储约定目录、原子写入与 12,000 字符上限、4/5 两代历史数据的迁移算法与原始快照恢复的判定顺序、update_user_profile/update_user_preferences两个工具与提示词注入的运行链路以及独立用户配置User Preferences设置页的 UI 结构与策略控制。文章同时以仓库源码MemorySpaceProfileDocumentRepository.kt、MemoryQueryToolExecutor.kt、ConversationService.kt 等作为实现证据帮助读者把设计文档落到真实代码调用链上。一、背景与设计目标为什么要让每个记忆空间拥有自己的user.md1.1 现状问题在 Release 1.12.05 中Operit 只在应用私有文件目录下存放一个全局user.md文档。此时记忆空间memory space本身已经通过稳定的标识符identifier互相隔离但用户画像文档并没有跟随记忆空间一起隔离——所有空间共享同一份全局文档。而更早的 Release 4 则存储了多个结构化档案structured profiles每个档案使用与其记忆数据库ObjectBox database相同的标识符。这意味着存在两代互不兼容的数据形态4 形态多份结构化PreferenceProfileJSON键为profile_id5 形态一份根级user.md 一份legacy-user-profiles.md归档外加memory_space_list、active_memory_space_id、memory_space_id元数据。1.2 设计目标Intentindex.md 明确了目标状态每个记忆空间拥有且仅拥有一份user.md当前激活空间active space负责向提示词提供文档上下文并接收自动画像更新面向用户的管理入口是独立的User Preferences 设置页而不是记忆库memory library界面已发布的全局文档不再被读取、注入、复制或展示仅作为一次性迁移的输入。一句话概括档案的所有权ownership从全局共享下沉到记忆空间私有同时把管理界面与记忆库解耦。二、存储层设计目录、原子写入与字符上限2.1 存储位置与文件命名依据 1_StorageAndMigration.md每份文档存放在应用私有文件目录下filesDir/memory-space-profiles/memory-space-id/user.md源码实现位于 MemorySpaceProfileDocumentRepository.kt其中常量与路径逻辑一一对应常量值含义STORAGE_DIRECTORYmemory-space-profiles档案根目录USER_FILE_NAMEuser.md文档文件名MAX_CONTENT_CHARS12_000单文档字符上限PUBLISHED_GLOBAL_USER_FILE_NAMEuser.md已发布的全局文档只读输入PUBLISHED_LEGACY_ARCHIVE_FILE_NAMElegacy-user-profiles.md5 归档文件只读输入MIGRATION_PREFERENCESmemory_space_profile_documents迁移专用 SharedPreferencesSCHEMA_VERSION_KEY/CURRENT_SCHEMA_VERSIONschema_version/2迁移 schema 标记路径构造逻辑见profileDirectory()与documentFile()第 223-230 行先按记忆空间 ID 建立子目录再拼接user.md。load()在文件不存在时会以空字符串原子创建保证一空间必有文档的不变量。2.2 原子写入与字符上限save()第 84-92 行在写入前强制校验require(markdown.length MAX_CONTENT_CHARS) { user.md exceeds the $MAX_CONTENT_CHARS character limit }写入通过 Android 的AtomicFile完成writeAtomically()第 299-311 行startWrite()写临时文件 →finishWrite()提交任何异常都会调用failWrite()回滚避免半截文件。整个写入路径由writeMutex串行化防止并发覆盖。reset()则把某空间的文档清空为delete()同时删除文档文件与其目录。2.3 独立的 schema 标记迁移版本标记与已发布全局文档标记完全分离仓库使用memory_space_profile_documents这个专属 SharedPreferences 文件记录schema_version当前为2。initialize()第 54-71 行在首次启动时比较版本低于目标版本则触发migrateReleasedData()并原子提交版本号。分离的意义在于全局user.md的存在与否不能用来判断是否已迁移必须依赖专用标记。三、两代历史数据迁移4 结构化档案与 5 全局文档迁移入口为migrateReleasedData()第 114-129 行其判定顺序至关重要if (manager.hasLegacyUserProfileMetadata()) { // 存在 profile_list → 视为 4 migrateLegacyStructuredProfiles(manager) return } if (manager.hasMemorySpaceMetadata()) { // 存在 memory_space_list → 视为 5 migratePublishedGlobalDocuments(manager) ... } migrateLegacyStructuredProfiles(manager) // 兜底3.1 4 结构化档案 → 记忆空间文档数据来源4 把每个档案以PreferenceProfileJSON 存储在profile_id键下其持久化字段恰好为id、name、birthDate、gender、personality、identity、occupation、aiStyle、isInitialized迁移专用的LegacyUserProfile具有完全相同的序列化形状。迁移动作migrateLegacyStructuredProfiles()第 131-140 行读取profile_list、active_profile_id、各profile_id记录readLegacyUserProfiles()汇总为快照为每个档案保留原 ID写入documentFile(profile.id)内容由LegacyUserProfile.toUserMarkdown()生成调用migrateLegacyProfilesToMemorySpaces()创建对应记忆空间并保留 ObjectBox 数据库标识符。关键设计点来自 1_StorageAndMigration.md 与 UserPreferencesManager.kt按 ID 而非显示名对应即使两个档案重名也不会互相选中或覆盖Markdown 段落格式与 5 转换器一致toUserMarkdown()第 256-263 行输出# About me标题然后按Basic information / Personality / Preferred assistant style三段式组织appendProfileSections()第 270-297 行与已发布 5 转换器产物同构分类锁 → 待决迁移状态4 的逐字段分类锁BIRTH_DATE_LOCKED等无法映射为整文档锁因此迁移时把profileAutoUpdateLocked snapshot.hasLegacyCategoryLocks置为锁定UserPreferencesManager.kt自动重写保持禁用直到用户在新的整文档锁策略下显式选择同时清理profile_id、PROFILE_LIST、ACTIVE_PROFILE_ID及各分类锁键。3.2 5 全局文档 → 唯一缺失空间数据来源5 用memory_space_list、active_memory_space_id、memory_space_id替代了档案键把激活档案写到filesDir/user.md其余 4 档案以 Markdown 段落形式归档到filesDir/legacy-user-profiles.md并打上独立的user_profile_documentschema 标记。迁移动作migratePublishedGlobalDocuments()第 148-195 行解析归档文件按##二级标题切分段落排除 Basic information / Personality / Preferred assistant style 三个固定节名得到ArchivedProfileDocument(name, content)列表对每个候选空间位置rootIndex检查移除该空间后剩余空间的名字序列是否是归档名字序列的子序列isSubsequenceOf()第 197-205 行。唯一满足条件的空间即根user.md的归属者其余归档段落按名字顺序逐一匹配剩余空间写入其文档仅当目标文档为空时才写入writeIfDocumentEmpty()根文档写入唯一缺失空间。为什么不用当前激活空间判定注释与文档都明确指出active_memory_space_id可能在 5 迁移之后又被用户切换过只有归档保留的 4 顺序才是名单序按名单顺序做子序列匹配才能还原原始所有权。若候选空间不唯一如空归档导致无法判定源码选择保留源文件并记录警告不做破坏性处理。3.3 一次性迁移与不再触碰迁移完成后根级user.md与legacy-user-profiles.md保留在磁盘上但仅被这一次性的 5 重建迁移读取此后永不修改也不会注入提示词。这与设计目标已发布全局文档不再被读取、注入、复制或展示一致。四、原始快照恢复兼容4 载荷的判定优先级与即时重启4.1 问题4 生成的原始快照raw snapshot包含完整的profile_list载荷。将其恢复到运行中的新版本进程时磁盘上可能同时存在遗留的 4 键与不完整的记忆空间列表。若仅凭存在 memory-space 列表就判定为 5会跳过剩余的 4 记录最终只留下一个空的默认空间。此外恢复路径在用户选择重启前会让当前进程继续存活其已打开的 DataStore 可能在备份文件被替换后写回过期的内存态偏好。4.2 变更6_RawSnapshotRestoreCompatibility.md分类顺序修正先检查profile_listhasLegacyUserProfileMetadata()存在即归类为 4之后才考虑 memory-space 元数据。源码注释UserPreferencesManager.kt明确说明raw 4 快照可被恢复到已创建默认空间的新进程遗留列表在记录被消费前始终是权威来源整目录恢复恢复目录时以快照的完整状态为准而不是与新文件合并从而移除陈旧的迁移标记原子恢复 立即重启文件原子替换成功导入后立刻重启保证下一个进程成为恢复后 DataStore 的第一个读取者杜绝旧进程回写陈旧偏好。预期结果被检查的 4 原始快照能恢复其三个结构化用户档案及原有记忆空间标识符而不是退化为只有一个空默认空间。五、运行时与自动更新注入、锁定与工具适配5.1 按激活空间加载文档并注入提示词2_RuntimeAndAutoUpdate.md 规定使用激活记忆空间的标识符加载一份档案文档用于提示词注入与工具更新。提示词注入的实际调用点在 ConversationService.kt当userProfileMarkdown非空且未禁用时系统提示词尾部会追加user_profile sourcememory-space/$effectiveMemorySpaceId/user.md ...文档内容... /user_profileeffectiveMemorySpaceId即当前激活空间 IDsource属性直接暴露文档属于哪个记忆空间的语义供模型理解上下文边界。5.2 自动画像更新管线与锁定门记忆自动保存候选管线本就按记忆空间维度运行每个空间独立执行。画像提取只写匹配的那个空间的文档并在仓库边界repository boundary检查整文档自动更新锁定。实现即saveAutomatic()MemorySpaceProfileDocumentRepository.ktval space UserPreferencesManager.getInstance(context) .getMemorySpaceFlow(memorySpaceId).first() if (!space.profileAutoUpdateEnabled || space.profileAutoUpdateLocked) return false save(memorySpaceId, markdown) return true两个策略开关直接决定自动写入是否放行字段含义profileAutoUpdateEnabled是否允许对话过程中的自动画像更新写入本文档profileAutoUpdateLocked整文档锁锁定后任何自动重写被拒手动编辑不受影响5.3 两个工具update_user_profile与update_user_preferences发布名不变但行为统一指向激活记忆空间的文档update_user_profile面向提示词可见的文档工具。实现见 MemoryQueryToolExecutor.kt要求markdown参数缺参时报错随后在Dispatchers.IO中调用MemorySpaceProfileDocumentRepository.save(resolveActiveProfileId(tool), markdown)成功返回 Successfully updated user.mdupdate_user_preferences隐藏适配器hidden adapter兼容已发布旧包与历史持久化调用。旧调用没有markdown参数因此该路径把偏好信息以## Imported profile update段落的形式保留进user.md而不恢复结构化档案运行时executeLegacyUserPreferencesUpdate()同文件第 752-802 行附近避免新旧两套运行时并存。工具注册与提示词可见性配置位于 ToolRegistration.kt 与 SystemToolPromptsInternal.kt其中update_user_profile在两处被定义分别对应不同提示词上下文。此外extended_memory_tools.js及 TS 源 extended_memory_tools.ts提供了脚本层面对用户画像工具的封装入口。六、用户配置 UI 的演进从记忆库内嵌到独立设置页6.1 第一阶段记忆空间配置 UI已被取代3_MemorySpaceConfigurationUi.md 记录了最初实现移除全局用户偏好路由与设置入口把文档编辑、自动更新控制、整文档锁全部塞进选中的记忆空间配置界面。该界面仍使用 ObjectBox 与角色卡绑定所依赖的稳定标识符只编辑该空间自己的user.md。该方案被标注为SUPERSEDED存储所有权与稳定标识符不变只是面向用户的管理位置后移——因为把个人档案管理放进记忆库的空间选择器会让个人画像管理看起来像记忆库操作。6.2 第二阶段独立用户配置 UI4_StandaloneUserConfigurationUi.md 确立最终形态恢复 Settings 中的 User Preferences 入口它拥有配置选择器与全部动作并把选中配置呈现为一个user.mdMarkdown 编辑器附带自动更新与整文档锁控制记忆库瘦身只保留浏览对应记忆数据库所需的激活空间选择器不再创建、重命名、删除或编辑用户配置兼容性配置继续使用既有记忆空间 ID因此升级自 4、5 或当前 worktree 实现的用户其memory-space-profiles/id/user.md、ObjectBox 数据库与固定角色卡绑定全部保持不变。6.3 第三阶段独立页打磨UI polish5_StandaloneUiPolish.md 针对初版动作区 两行全宽策略行 标签页 编辑器 保存按钮纵向堆叠的问题做了分层重构仓库实现位于 UserPreferencesSettingsScreen.kt恢复 5 编辑器结构居中内容宽度、紧凑的标签/保存工具栏、全高编辑器、语法高亮、空态占位文案、字符计数见第 560-571 行实时显示draftMarkdown.length / 12000超限变红、文档菜单保留 4 档案管理器的有用部分收敛为一条紧凑的选择器栏动作菜单化激活、重命名、删除归入档案动作菜单重命名/新建走AlertDialog见第 664-719 行新建后自动设为激活空间策略 Sheet自动更新与整文档锁两个开关放入ModalBottomSheet第 580-662 行切换即持久化persistPolicy()无需额外保存按钮紧凑跳转动作一键激活所选档案关联的记忆空间并直接打开记忆库。本步骤不改变任何存储、迁移、运行时注入或记忆绑定行为是纯 UI 层的收敛。七、兼容性总览与升级路径综合 index.md 与各子文档三类升级路径与最终状态可归纳如下来源迁移方式结果5 安装归档legacy-user-profiles.md按记忆空间名单序匹配根user.md归属唯一缺失空间源文件一次性读取后不再触碰每个空间一份文档所有权不随激活空间切换漂移4 安装profile_list/active_profile_id/profile_id直接迁移为对应空间的user.md保留 ID 与 ObjectBox 数据库分类锁转为待决整文档锁重名档案不串位、不覆盖原始 4 快照恢复先判profile_list为 4整目录恢复 原子替换 立即重启结构化档案与记忆空间标识符完整还原完成迁移后运行时行为统一为系统提示词按激活空间注入user_profile sourcememory-space/id/user.md自动画像写入经仓库边界profileAutoUpdateEnabled !profileAutoUpdateLocked门控update_user_profile可见与update_user_preferences隐藏适配都写激活空间文档用户通过独立 User Preferences 设置页管理文档、策略开关与空间动作记忆库仅保留空间选择器。附关键源码与文档索引设计总览docs/TODO/memory_space_profile_documents/index.md存储与迁移1_StorageAndMigration.md运行时与自动更新2_RuntimeAndAutoUpdate.md独立配置 UI4_StandaloneUserConfigurationUi.md、5_StandaloneUiPolish.md快照恢复兼容6_RawSnapshotRestoreCompatibility.md存储实现MemorySpaceProfileDocumentRepository.kt偏好/空间元数据UserPreferencesManager.kt提示词注入ConversationService.kt工具执行MemoryQueryToolExecutor.kt独立配置 UI 实现UserPreferencesSettingsScreen.kt赞分享AI Agent人工智能大模型AI 应用工具调用本地部署MCP ClientsAgent 记忆【免费下载链接】OperitThe most powerful AI agent and AI chat software on Android/Operit是一款Android上能力最为强大、发展最久的AI Agent项目地址https://gitcode.com/gh_mirrors/op/Operit点击查看免费下载相关推荐时光宝盒一键留存QQ空间完整记忆档案时光宝盒一键留存QQ空间完整记忆档案 在数字化浪潮中那些记录青春岁月的QQ空间动态正面临不可预见的风险。账号异常、平台政策调整、服务器故障都可能让这些珍贵的网页爬虫数据分析3步打造智能文档空间Supermemory空间与文档管理全攻略3步打造智能文档空间Supermemory空间与文档管理全攻略 Supermemory是一款强大的个人知识管理工具帮助用户构建专属的第二大脑。它就像为你的书人工智能RAGAgent 记忆AI Agent后端MCP 服务知识图谱前端一键永久存档GetQzonehistory帮你完整备份QQ空间所有记忆一键永久存档GetQzonehistory帮你完整备份QQ空间所有记忆 你是否曾担心那些承载青春回忆的QQ空间说说会随着时间流逝而消失数字时代的记忆如此脆弱网页爬虫数据分析上一篇Barlow字体终极指南为什么这款几何无衬线字体能提升你的设计质感下一篇Modbus.Net如何构建一个支持多协议、可扩展的工业通信框架创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
相关推荐
better-sqlite3 贡献指南：从 C++ 原生插件到发布流程的完整协作规范
数据库嵌入式数据库 【免费下载链接】better-sqlite3 The fastest and simplest library for SQLite3 in Node.js. 项目地址： https://gitcode.com/gh_mirrors/be/better-sqlite3 点击查看 免费下载 本篇技术指南围绕 better-sqlite3 的官方贡献文档（do… · 2026/9/28 3:05:40
YOLO车辆检测数据集处理：从解压到训练的全流程指南
/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/28 3:05:40
搞懂网站内容建设是什么：3个免费工具让你流量翻倍
搞懂网站内容建设是什么：3个免费工具让你流量翻倍 域名买好了，服务器也租了，但打开后台一看，脑子还是浆糊？别慌，这种“域名服务器搞不懂”的焦虑，十个有九个建站的人都经历过。其实，你缺的不是技术，而是一套清晰的内容逻辑。今天我不讲虚的，直接给… · 2026/9/28 3:05:33
Spingboot启动预热的实现
启动预热的适用场景启动预热适合以下情况：数据主要来自第三方接口，无法直接从本地数据库读取。第三方接口响应较慢，首次访问容易超时。一个页面需要调用多个第三方接口或逐项查询。数据读取频繁，但变化不频繁。希望服务启动后&… · 2026/9/28 3:40:12
Understanding Driving Risks using Large Language Models: Toward Elderly Driver Assessment
文章主要内容总结 本文研究了多模态大语言模型（具体为ChatGPT-4o）利用静态行车记录仪图像进行类人交通场景解读的潜力，重点聚焦与老年司机评估相关的三项任务：交通密度评估、交叉口可见性评估和停车标志识别。这些任务需上下文推理而非简单目标检测。研究采用零样本、少样… · 2026/9/28 3:32:43
Leveraging Large Language Models for Classifying App Users‘ Feedback
文章主要内容总结 本文聚焦于利用大型语言模型（LLMs）解决应用用户反馈分类的挑战，传统方法依赖有监督机器学习，但受限于标注数据集的规模和质量。研究通过三个核心实验评估了4种先进LLMs（GPT-3.5-Turbo、GPT-4o、Flan-T5、Llama3-70b）的性能： LLMs在用户反馈分类中的基… · 2026/9/28 3:32:43
Using Large Language Models for Legal Decision-Making in Austrian Value-Added Tax Law: An Experim...
文章主要内容总结 本文通过实验评估了大型语言模型（LLMs）在奥地利及欧盟增值税（VAT）法框架下辅助法律决策的能力。研究聚焦于两种提升LLM性能的方法——微调（fine-tuning）和检索增强生成（RAG），并在两类案例中进行验证：一是权威教科书案例，二是税务咨询公司的真实案… · 2026/9/28 3:32:43
学Java别走弯路，这5个方向最吃香
学Java的人很多，但学明白的人不多。有人学了半年还在写控制台程序，有人一年就能独当一面。差别不在天赋，而在方向。Java生态太庞大了，什么都学等于什么都没学。选对方向，事半功倍。今天盘点当前最吃香的5个Java方向&am… · 2026/9/28 3:32:15
AlphaAgents: Large Language Model based Multi-Agents for Equity Portfolio Constructions
AlphaAgents相关总结与翻译 一、文章主要内容总结 （一）研究背景与问题 传统股票投资组合管理依赖人类分析师处理海量信息（如财务披露、财报、市场新闻等），存在信息处理效率低、易受认知偏差（如损失厌恶、过度自信）影响的问题，可能错失投资收益机会。尽管AI在数据处理… · 2026/9/28 3:32:08
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现
简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急
汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习
简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
制作网页比较方便的软件怎么选?一文搞懂避坑指南
制作网页比较方便的软件怎么选?一文搞懂避坑指南 很多老板一上来就问：做个网站多少钱？但我反问他：你的域名买了吗？服务器租了吗？他一脸懵。这就是典型的“域名服务器搞不懂”。别急，今天咱们不聊虚的，直接 一文搞懂 那些让你头秃的技术名词。… · 2026/9/28 0:00:06
婚恋网站实战案例：避开3个高价坑，省钱50%还能跑赢流量
婚恋网站实战案例：避开3个高价坑，省钱50%还能跑赢流量 找婚恋网站建站公司，最怕的就是被坑高价。很多同行跟我吐槽，报价单上写得模棱两可，功能栏里全是“高级定制”、“专属UI”，结果落地全是套壳。今天不聊虚的，直接甩几个我经手的 实战案例… · 2026/9/28 0:00:19
济南做网站多少钱：3个案例拆解，防黑源码下载全攻略
济南做网站多少钱：3个案例拆解，防黑源码下载全攻略 上周济南一个做建材的老板找我，脸都绿了。他的官网首页弹出了赌博广告，后台被植入了挖矿脚本。他慌得问我：“网站被黑挂马不知道怎么办？能不能直接找之前的外包公司要源码下载，看看哪里被动了手脚？… · 2026/9/28 0:00:25