用途:该技能帮助把一个项目的记忆层从自托管 mem0 OSS SDK 迁移到 mem0 Platform 托管 SDK,适用于智能体、RAG 流水线、API 服务、聊天机器人、后台 worker 等任意项目形态。
主要能力:先发现项目中 mem0 的实际使用位置,编写迁移计划供开发者审阅,获得批准后再执行。核心改动是把 Memory / Memory.from_config({...}) 换成 MemoryClient()(从环境变量读取 API key),删除本地 vector_store、llm、embedder、reranker、history_db_path 及遗留 graph_store 配置,并按托管调用约定调整各调用点(实体 ID 放入 filters、分页等),同时标记无法一一对应的改动供人工决策。
使用方式:按阶段推进——阶段 0 确认已有 MEM0_API_KEY(可在 https://app.mem0.ai 获取,需写入 .env 或密钥管理,不可硬编码);阶段 1 检测语言与已安装版本并全局搜索 import/实例化、配置块、各调用点、依赖与环境变量;阶段 2 用 inspect 或 node_modules 中的类型确认已安装 SDK 的真实签名,参考资料 https://docs.mem0.ai/migration/oss-to-platform 与 https://docs.mem0.ai/migration/oss-v2-to-v3;阶段 3 逐点映射并标记需人工决定的问题;阶段 4 将计划写入仓库根目录的 MEM0_MIGRATION_PLAN.md 后停止等待审阅;阶段 5 批准后逐文件执行并验证(可导入/类型检查/字节编译通过,用真实 key 做 add→search/get_all→delete_all 冒烟测试;托管 add 是异步的,需短暂等待)。
适用场景与限制:仅限 mem0 相关代码、配置、依赖和环境变量,保持项目原有行为、结构与风格,不做重命名或顺带重构;不处理本地已存记忆的数据迁移(除非开发者明确要求);自托管/数据驻留、本地模型选择、图记忆、自定义提示、热路径网络往返等需人工判断;验证时不应用 .mem0/ 目录作为判断依据,因为客户端仍会创建 ~/.mem0/config.json。