[{"data":1,"prerenderedAt":581},["ShallowReactive",2],{"\u002Fcn\u002Fopen_source\u002Fhome\u002Farchitecture":3,"surround-\u002Fcn\u002Fopen_source\u002Fhome\u002Farchitecture":565},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":558,"description":475,"extension":559,"links":6,"meta":560,"navigation":6,"path":561,"seo":562,"stem":563,"__hash__":564},"docs\u002Fcn\u002Fopen_source\u002Fhome\u002Farchitecture.md","架构设计",null,{"type":8,"value":9,"toc":546},"minimark",[10,14,19,28,33,61,65,72,77,84,133,138,158,162,174,217,223,234,237,240,249,268,272,289,293,296,348,373,376,379,460,463,466,476,518,521,532],[11,12,13],"h2",{"id":13},"核心模块",[15,16,18],"h3",{"id":17},"mos-memory-operating-system记忆操作系统","MOS (Memory Operating System，记忆操作系统)",[20,21,22,23,27],"p",{},"MemOS 的编排层——管理跨多种记忆类型（纯文本、激活、参数化）的预测性、异步调度，并编排",[24,25,26],"strong",{},"多用户、多会话","记忆工作流。",[20,29,30],{},[24,31,32],{},"核心功能",[34,35,36,43,49,55],"ul",{},[37,38,39,42],"li",{},[24,40,41],{},"统一 API 网关","：为所有记忆操作（添加、搜索、更新、传输、回滚）提供一致接口",[37,44,45,48],{},[24,46,47],{},"工作流编排","：协调 MemCube、MemReader、MemScheduler 等组件的执行流程",[37,50,51,54],{},[24,52,53],{},"互操作性支持","：通过记忆交换协议 (MIP) 实现跨模型、跨设备的记忆迁移",[37,56,57,60],{},[24,58,59],{},"资源调度","：智能分配计算资源，平衡实时响应与后台处理需求",[15,62,64],{"id":63},"memcube-记忆容器","MemCube (记忆容器)",[20,66,67,68,71],{},"MemCube 是 MemOS 的",[24,69,70],{},"模块化记忆存储单元","，可视为一个独立且可移植的“记忆卡”。每个 MemCube 可专门服务于特定用户、智能体或会话，容纳一种或多种记忆类型。",[20,73,74],{},[24,75,76],{},"多 Cube 支持 (Multi-Cube):",[20,78,79,80,83],{},"MemOS 支持通过",[24,81,82],{},"组合视图 (Composite View)"," 同时操作多个 MemCube，实现灵活的记忆隔离与共享：",[85,86,87,103],"table",{},[88,89,90],"thead",{},[91,92,93,97,100],"tr",{},[94,95,96],"th",{},"操作类型",[94,98,99],{},"策略",[94,101,102],{},"应用场景",[104,105,106,120],"tbody",{},[91,107,108,114,117],{},[109,110,111],"td",{},[24,112,113],{},"写入",[109,115,116],{},"扇出写入 (Fan-out Write)",[109,118,119],{},"将记忆同时写入用户个人 Cube 和项目共享 Cube",[91,121,122,127,130],{},[109,123,124],{},[24,125,126],{},"读取",[109,128,129],{},"并行搜索 (Parallel Search)",[109,131,132],{},"同时查询多个 Cube，聚合结果提供全局视图",[20,134,135],{},[24,136,137],{},"动态管理能力:",[34,139,140,146,152],{},[37,141,142,145],{},[24,143,144],{},"热插拔支持","：可在运行时动态注册、更新或移除 MemCube",[37,147,148,151],{},[24,149,150],{},"容器化存储","：支持记忆在会话、模型和设备间的安全传输",[37,153,154,157],{},[24,155,156],{},"隔离保障","：确保不同用户或应用间的记忆数据相互隔离",[15,159,161],{"id":160},"异步添加机制-asynchronous-addition","异步添加机制 (Asynchronous Addition)",[20,163,164,165,169,170,173],{},"为了在高并发场景下保持低延迟，MemOS 提供了异步记忆添加模式 (",[166,167,168],"code",{},"async_mode",")，利用 ",[24,171,172],{},"MemScheduler"," 进行后台调度：",[85,175,176,189],{},[88,177,178],{},[91,179,180,183,186],{},[94,181,182],{},"记忆类型",[94,184,185],{},"处理策略",[94,187,188],{},"优势",[104,190,191,204],{},[91,192,193,198,201],{},[109,194,195],{},[24,196,197],{},"文本记忆",[109,199,200],{},"快速提取 + 异步处理",[109,202,203],{},"API 立即返回基础结果，复杂处理后台执行",[91,205,206,211,214],{},[109,207,208],{},[24,209,210],{},"偏好记忆",[109,212,213],{},"全异步处理",[109,215,216],{},"最大化减少 API 响应延迟",[20,218,219,222],{},[24,220,221],{},"MemScheduler 角色：","\n作为异步任务调度器，负责：",[34,224,225,228,231],{},[37,226,227],{},"管理后台处理任务的优先级队列",[37,229,230],{},"协调重索引、图推理等计算密集型操作",[37,232,233],{},"监控任务状态，确保处理一致性",[15,235,236],{"id":236},"记忆类型体系",[20,238,239],{},"MemOS 支持几种专门的记忆类型以满足不同需求：",[241,242,244,245,248],"h4",{"id":243},"_1-参数化记忆即将推出","1. 参数化记忆(",[24,246,247],{},"即将推出",")",[34,250,251,257,262],{},[37,252,253,256],{},[24,254,255],{},"特性","： 知识固化于模型权重中，推理零延迟",[37,258,259,261],{},[24,260,102],{},"：稳定的领域知识、核心技能",[37,263,264,267],{},[24,265,266],{},"生命周期","：长期持久，更新成本较高",[241,269,271],{"id":270},"_2-激活记忆","2. 激活记忆",[34,273,274,279,284],{},[37,275,276,278],{},[24,277,255],{},"：运行时 KV 缓存与隐藏状态，快速复用",[37,280,281,283],{},[24,282,102],{},"：多轮对话上下文、频繁访问的背景信息",[37,285,286,288],{},[24,287,266],{},"：短期有效，会话级保持",[241,290,292],{"id":291},"_3-明文记忆","3. 明文记忆",[20,294,295],{},"结构化或非结构化知识块；可编辑、可追溯，适合快速更新、个性化和多代理共享。",[85,297,298,314],{},[88,299,300],{},[91,301,302,305,308,311],{},[94,303,304],{},"记忆子类",[94,306,307],{},"存储结构",[94,309,310],{},"核心优势",[94,312,313],{},"典型应用",[104,315,316,332],{},[91,317,318,323,326,329],{},[109,319,320],{},[24,321,322],{},"GeneralTextMemory",[109,324,325],{},"向量存储",[109,327,328],{},"语义检索灵活，支持元数据过滤",[109,330,331],{},"非结构化文档、聊天记录",[91,333,334,339,342,345],{},[109,335,336],{},[24,337,338],{},"TreeTextMemory",[109,340,341],{},"图结构存储",[109,343,344],{},"层次化组织，支持多跳推理",[109,346,347],{},"结构化知识库、用户画像",[349,350,352],"note",{"title":351},"架构选型建议",[20,353,354,357,360,361,363,364,367,369,370,372],{},[24,355,356],{},"起步建议",[358,359],"br",{},"：从 ",[166,362,322],{}," 开始快速验证概念\n",[24,365,366],{},"演进路径",[358,368],{},"：随着业务复杂度提升，逐步引入 ",[166,371,338],{}," 处理结构化知识",[241,374,375],{"id":375},"基础支撑组件",[20,377,378],{},"MemOS 的基础模块提供标准化能力，确保系统的可扩展性与一致性：",[85,380,381,393],{},[88,382,383],{},[91,384,385,388,390],{},[94,386,387],{},"组件类别",[94,389,32],{},[94,391,392],{},"实现示例",[104,394,395,408,421,434,447],{},[91,396,397,402,405],{},[109,398,399],{},[24,400,401],{},"文本处理",[109,403,404],{},"智能分块、记忆提取",[109,406,407],{},"Chunkers, MemReaders",[91,409,410,415,418],{},[109,411,412],{},[24,413,414],{},"向量化",[109,416,417],{},"文本嵌入生成",[109,419,420],{},"Embedders (bge-m3, text-embedding-3-large)",[91,422,423,428,431],{},[109,424,425],{},[24,426,427],{},"存储接口",[109,429,430],{},"多数据库适配",[109,432,433],{},"GraphDBs (Neo4j, Qdrant, PolarDB)",[91,435,436,441,444],{},[109,437,438],{},[24,439,440],{},"模型连接",[109,442,443],{},"统一 LLM 接口",[109,445,446],{},"LLMs (OpenAI, Ollama)",[91,448,449,454,457],{},[109,450,451],{},[24,452,453],{},"质量优化",[109,455,456],{},"检索结果重排",[109,458,459],{},"Rerankers (bge-reranker-v2-m3)",[11,461,462],{"id":462},"代码组织架构",[20,464,465],{},"MemOS 项目组织清晰，支持即插即用：",[467,468,473],"pre",{"className":469,"code":471,"language":472},[470],"language-text","src\u002Fmemos\u002F\n    api\u002F           # API 定义\n    chunkers\u002F      # 文本分块工具\n    configs\u002F       # 配置模式\n    context\u002F       # 日志上下文\n    embedders\u002F     # 嵌入模型\n    graph_dbs\u002F     # 图数据库后端 (例如，Neo4j)\n    vec_dbs\u002F       # 向量数据库后端 (例如，Qdrant)\n    llms\u002F          # LLM 连接器\n    mem_agent\u002F     # 深度检索\n    mem_chat\u002F      # 记忆增强聊天逻辑\n    mem_cube\u002F      # MemCube 管理\n    mem_feedback   # 记忆反馈\n    mem_os\u002F        # MOS 编排\n    mem_reader\u002F    # 记忆读取器\n    mem_scheduler\u002F # 记忆调度模块\n    memories\u002F      # 记忆类型实现\n    multi_mem_cube\u002F# 多视图cube\n    parsers\u002F       # 解析工具\n    reranker\u002F      # 重排模块\n    templates\u002F     # 提示词模板\n    types\u002F         # 类型定义\n","text",[166,474,471],{"__ignoreMap":475},"",[349,477,479,486],{"title":478},"开发指引",[20,480,481,484],{},[24,482,483],{},"专业提示",[358,485],{},[34,487,488,498,508],{},[37,489,490,493,494,497],{},[24,491,492],{},"快速实验","：使用 ",[166,495,496],{},"examples\u002F"," 目录中的示例快速验证功能",[37,499,500,503,504,507],{},[24,501,502],{},"深度定制","：参考 ",[166,505,506],{},"src\u002F"," 中的模块实现进行二次开发",[37,509,510,513,514,517],{},[24,511,512],{},"配置管理","：所有组件均支持通过 ",[166,515,516],{},"configs\u002F"," 进行灵活配置",[11,519,520],{"id":520},"可扩展性",[20,522,523,524,527,528,531],{},"MemOS 是",[24,525,526],{},"模块化设计的","。\n添加您自己的记忆类型、存储后端或 LLM 连接器，只需最少的更改——这要归功于其",[24,529,530],{},"统一配置和工厂模式","。",[349,533,534],{},[20,535,536,538,540,545],{},[24,537,483],{},[358,539],{},[541,542,544],"a",{"href":543},"\u002Fopen_source\u002Fcontribution\u002Foverview","贡献"," 一个新的后端或分享您的自定义记忆类型——这很容易插入。",{"title":475,"searchDepth":547,"depth":547,"links":548},2,[549,556,557],{"id":13,"depth":547,"text":13,"children":550},[551,553,554,555],{"id":17,"depth":552,"text":18},3,{"id":63,"depth":552,"text":64},{"id":160,"depth":552,"text":161},{"id":236,"depth":552,"text":236},{"id":462,"depth":547,"text":462},{"id":520,"depth":547,"text":520},"MemOS 采用模块化设计，各核心组件协同工作，将传统 LLM 升级为具备完整记忆生命周期管理能力的记忆增强系统。","md",{},"\u002Fcn\u002Fopen_source\u002Fhome\u002Farchitecture",{"title":5,"description":475},"cn\u002Fopen_source\u002Fhome\u002Farchitecture","mFFqX7_IUeBQYf-qYQkV4aviZ_YhemPl7flNP08QBAA",[566,574],{"title":567,"path":568,"stem":569,"icon":570,"framework":6,"module":6,"class":571,"target":-1,"active":572,"defaultOpen":572,"children":-1,"description":573},"核心概念","\u002Fcn\u002Fopen_source\u002Fhome\u002Fcore_concepts","open_source\u002Fhome\u002Fcore_concepts","i-ri-lightbulb-line",[],false,"MemOS 将记忆视为一等资源。其核心设计围绕如何为您的 LLM 应用程序组织、存储、检索和治理记忆。",{"title":575,"path":576,"stem":577,"icon":578,"framework":6,"module":6,"class":579,"target":-1,"active":572,"defaultOpen":572,"children":-1,"description":580},"REST API 服务","\u002Fcn\u002Fopen_source\u002Fgetting_started\u002Frest_api_server","open_source\u002Fgetting_started\u002Frest_api_server","i-ri-file-code-line",[],"MemOS 提供了一个使用 FastAPI 编写的 REST API 服务。用户可以通过 REST 接口执行所有操作。",1774339749993]