[{"data":1,"prerenderedAt":1062},["ShallowReactive",2],{"\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fcommon_errors_solutions":3,"surround-\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fcommon_errors_solutions":1047},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":6,"description":112,"extension":1041,"links":6,"meta":1042,"navigation":6,"path":1043,"seo":1044,"stem":1045,"__hash__":1046},"docs\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fcommon_errors_solutions.md","常见错误与解决方案",null,{"type":8,"value":9,"toc":1023},"minimark",[10,15,20,45,55,80,87,93,147,151,168,173,293,297,301,314,318,371,375,378,489,492,633,637,641,650,655,765,769,778,824,828,837,842,1019],[11,12,14],"h2",{"id":13},"_1-数据库与向量相关错误","1. 数据库与向量相关错误",[16,17,19],"h3",{"id":18},"embedding-维度不匹配","Embedding 维度不匹配",[21,22,23,27,28,32,33,36,37,40,41,44],"p",{},[24,25,26],"strong",{},"现象","：\n更改 Embedding 模型后（例如从 ",[29,30,31],"code",{},"openai"," 切换到 ",[29,34,35],{},"ollama","），系统报错或检索效果极差。\n日志中可能出现 ",[29,38,39],{},"Dimension mismatch"," 或 Qdrant 相关的 ",[29,42,43],{},"Wrong input vector size"," 错误。",[21,46,47,50,51,54],{},[24,48,49],{},"原因","：\nQdrant 在创建 Collection 时会根据配置文件中的 ",[29,52,53],{},"vector_dimension"," 固定向量维度。",[56,57,58,66,73],"ul",{},[59,60,61,62,65],"li",{},"OpenAI ",[29,63,64],{},"text-embedding-3-small",": 1536 维",[59,67,68,69,72],{},"Ollama ",[29,70,71],{},"nomic-embed-text",": 768 维",[59,74,75,76,79],{},"BAAI ",[29,77,78],{},"bge-m3",": 1024 维",[21,81,82,83,86],{},"MemOS 的 ",[29,84,85],{},"QdrantVecDB"," 在初始化时，如果发现 Collection 已存在，会跳过创建步骤。此时如果使用了新维度的模型，写入向量时就会报错。",[21,88,89,92],{},[24,90,91],{},"解决方案","：",[94,95,96,141],"ol",{},[59,97,98,101,102,105,106],{},[24,99,100],{},"修改 Collection 名称","：在配置文件中更改 ",[29,103,104],{},"collection_name","，让 MemOS 创建一个新的 Collection。\n",[107,108,113],"pre",{"className":109,"code":110,"language":111,"meta":112,"style":112},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","vec_db:\n  config:\n    collection_name: \"memos_v2\" # 原名为 memos_v1\n    vector_dimension: 768       # 确保此维度与新模型一致\n","yaml","",[29,114,115,123,129,135],{"__ignoreMap":112},[116,117,120],"span",{"class":118,"line":119},"line",1,[116,121,122],{},"vec_db:\n",[116,124,126],{"class":118,"line":125},2,[116,127,128],{},"  config:\n",[116,130,132],{"class":118,"line":131},3,[116,133,134],{},"    collection_name: \"memos_v2\" # 原名为 memos_v1\n",[116,136,138],{"class":118,"line":137},4,[116,139,140],{},"    vector_dimension: 768       # 确保此维度与新模型一致\n",[59,142,143,146],{},[24,144,145],{},"删除旧数据","：如果你在开发环境，可以直接删除 Qdrant 的存储卷或 Drop 掉旧的 Collection。",[16,148,150],{"id":149},"数据后端启动失败-neo4jqdrant","数据后端启动失败 (Neo4j\u002FQdrant)",[21,152,153,155,156,159,160,163,164,167],{},[24,154,26],{},"：\n启动 MemOS 时报错 ",[29,157,158],{},"ConnectionRefusedError",", ",[29,161,162],{},"ServiceUnavailable"," 或 ",[29,165,166],{},"AuthError","。",[21,169,170,92],{},[24,171,172],{},"常见原因与检查清单",[94,174,175,204,238],{},[59,176,177,180,181],{},[24,178,179],{},"Docker 容器未启动","：\n确保你已经运行了必要的中间件容器。",[107,182,186],{"className":183,"code":184,"language":185,"meta":112,"style":112},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","docker ps\n# 检查是否有 neo4j 和 qdrant 容器在运行\n","bash",[29,187,188,198],{"__ignoreMap":112},[116,189,190,194],{"class":118,"line":119},[116,191,193],{"class":192},"sBMFI","docker",[116,195,197],{"class":196},"sfazB"," ps\n",[116,199,200],{"class":118,"line":125},[116,201,203],{"class":202},"sHwdD","# 检查是否有 neo4j 和 qdrant 容器在运行\n",[59,205,206,209,210,213,214,217,218],{},[24,207,208],{},"端口未映射","：\n检查 ",[29,211,212],{},"docker run"," 命令是否包含了 ",[29,215,216],{},"-p"," 参数。",[56,219,220,227],{},[59,221,222,223,226],{},"Qdrant 需要暴露 ",[29,224,225],{},"6333"," (gRPC\u002FHTTP)",[59,228,229,230,233,234,237],{},"Neo4j 需要暴露 ",[29,231,232],{},"7474"," (HTTP) 和 ",[29,235,236],{},"7687"," (Bolt)",[59,239,240,243,244,163,247,250,251,279,282],{},[24,241,242],{},"Neo4j 认证失败","：\nMemOS 默认配置通常使用 ",[29,245,246],{},"neo4j\u002Fpassword",[29,248,249],{},"neo4j\u002Fneo4j","。\n请检查你的环境变量或配置文件：",[107,252,254],{"className":183,"code":253,"language":185,"meta":112,"style":112},"export NEO4J_PASSWORD=\"your_actual_password\"\n",[29,255,256],{"__ignoreMap":112},[116,257,258,262,266,270,273,276],{"class":118,"line":119},[116,259,261],{"class":260},"spNyl","export",[116,263,265],{"class":264},"sTEyZ"," NEO4J_PASSWORD",[116,267,269],{"class":268},"sMK4o","=",[116,271,272],{"class":268},"\"",[116,274,275],{"class":196},"your_actual_password",[116,277,278],{"class":268},"\"\n",[280,281],"br",{},[283,284,285,286,292],"em",{},"注意：Neo4j 首次启动要求修改默认密码，请确保已在浏览器 (",[287,288,289],"a",{"href":289,"rel":290},"http:\u002F\u002Flocalhost:7474",[291],"nofollow",") 中完成此步骤。",[11,294,296],{"id":295},"_2-模型服务错误","2. 模型服务错误",[16,298,300],{"id":299},"ollama-连接失败","Ollama 连接失败",[21,302,303,305,306,309,310,313],{},[24,304,26],{},"：\n报错 ",[29,307,308],{},"Connection refused"," 连接到 ",[29,311,312],{},"localhost:11434"," 失败，或者提示模型不存在。",[21,315,316,92],{},[24,317,91],{},[94,319,320,329,354],{},[59,321,322,325,326,167],{},[24,323,324],{},"启动服务","：确保在终端运行了 ",[29,327,328],{},"ollama serve",[59,330,331,334,335,338,339],{},[24,332,333],{},"拉取模型","：MemOS 的 ",[29,336,337],{},"OllamaEmbedder"," 会尝试检查本地模型，如果不存在会尝试 pull，但建议手动执行以确保成功：\n",[107,340,342],{"className":183,"code":341,"language":185,"meta":112,"style":112},"ollama pull nomic-embed-text\n",[29,343,344],{"__ignoreMap":112},[116,345,346,348,351],{"class":118,"line":119},[116,347,35],{"class":192},[116,349,350],{"class":196}," pull",[116,352,353],{"class":196}," nomic-embed-text\n",[59,355,356,359,360,363,364,367,368,167],{},[24,357,358],{},"地址问题","：如果是 Docker 运行 MemOS，",[29,361,362],{},"localhost"," 指向容器内部。需使用 ",[29,365,366],{},"host.docker.internal"," (Mac\u002FWindows) 或宿主机 IP (Linux) 配置 ",[29,369,370],{},"api_base",[11,372,374],{"id":373},"_3-配置错误","3. 配置错误",[16,376,377],{"id":377},"缺失必要字段",[107,379,383],{"className":380,"code":381,"language":382,"meta":112,"style":112},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# ✅ 始终需要包含必填字段\nllm_config = {\n    \"backend\": \"openai\",\n    \"config\": {\n        \"api_key\": \"your-api-key\",\n        \"model_name_or_path\": \"gpt-4\"\n    }\n}\n","python",[29,384,385,390,400,423,436,458,477,483],{"__ignoreMap":112},[116,386,387],{"class":118,"line":119},[116,388,389],{"class":202},"# ✅ 始终需要包含必填字段\n",[116,391,392,395,397],{"class":118,"line":125},[116,393,394],{"class":264},"llm_config ",[116,396,269],{"class":268},[116,398,399],{"class":268}," {\n",[116,401,402,405,408,410,413,416,418,420],{"class":118,"line":131},[116,403,404],{"class":268},"    \"",[116,406,407],{"class":196},"backend",[116,409,272],{"class":268},[116,411,412],{"class":268},":",[116,414,415],{"class":268}," \"",[116,417,31],{"class":196},[116,419,272],{"class":268},[116,421,422],{"class":268},",\n",[116,424,425,427,430,432,434],{"class":118,"line":137},[116,426,404],{"class":268},[116,428,429],{"class":196},"config",[116,431,272],{"class":268},[116,433,412],{"class":268},[116,435,399],{"class":268},[116,437,439,442,445,447,449,451,454,456],{"class":118,"line":438},5,[116,440,441],{"class":268},"        \"",[116,443,444],{"class":196},"api_key",[116,446,272],{"class":268},[116,448,412],{"class":268},[116,450,415],{"class":268},[116,452,453],{"class":196},"your-api-key",[116,455,272],{"class":268},[116,457,422],{"class":268},[116,459,461,463,466,468,470,472,475],{"class":118,"line":460},6,[116,462,441],{"class":268},[116,464,465],{"class":196},"model_name_or_path",[116,467,272],{"class":268},[116,469,412],{"class":268},[116,471,415],{"class":268},[116,473,474],{"class":196},"gpt-4",[116,476,278],{"class":268},[116,478,480],{"class":118,"line":479},7,[116,481,482],{"class":268},"    }\n",[116,484,486],{"class":118,"line":485},8,[116,487,488],{"class":268},"}\n",[16,490,491],{"id":491},"后端不匹配",[107,493,495],{"className":380,"code":494,"language":382,"meta":112,"style":112},"# ✅ KVCache 需要使用 HuggingFace 后端\n# 参考 src\u002Fmemos\u002Fmemories\u002Factivation\u002Fkv.py\nkv_config = {\n    \"backend\": \"kv_cache\",\n    \"config\": {\n        \"extractor_llm\": {\n            \"backend\": \"huggingface\",\n            \"config\": {\n                \"model_name_or_path\": \"Qwen\u002FQwen3-1.7B\"\n            }\n        }\n    }\n}\n",[29,496,497,502,507,516,535,547,560,580,592,611,617,623,628],{"__ignoreMap":112},[116,498,499],{"class":118,"line":119},[116,500,501],{"class":202},"# ✅ KVCache 需要使用 HuggingFace 后端\n",[116,503,504],{"class":118,"line":125},[116,505,506],{"class":202},"# 参考 src\u002Fmemos\u002Fmemories\u002Factivation\u002Fkv.py\n",[116,508,509,512,514],{"class":118,"line":131},[116,510,511],{"class":264},"kv_config ",[116,513,269],{"class":268},[116,515,399],{"class":268},[116,517,518,520,522,524,526,528,531,533],{"class":118,"line":137},[116,519,404],{"class":268},[116,521,407],{"class":196},[116,523,272],{"class":268},[116,525,412],{"class":268},[116,527,415],{"class":268},[116,529,530],{"class":196},"kv_cache",[116,532,272],{"class":268},[116,534,422],{"class":268},[116,536,537,539,541,543,545],{"class":118,"line":438},[116,538,404],{"class":268},[116,540,429],{"class":196},[116,542,272],{"class":268},[116,544,412],{"class":268},[116,546,399],{"class":268},[116,548,549,551,554,556,558],{"class":118,"line":460},[116,550,441],{"class":268},[116,552,553],{"class":196},"extractor_llm",[116,555,272],{"class":268},[116,557,412],{"class":268},[116,559,399],{"class":268},[116,561,562,565,567,569,571,573,576,578],{"class":118,"line":479},[116,563,564],{"class":268},"            \"",[116,566,407],{"class":196},[116,568,272],{"class":268},[116,570,412],{"class":268},[116,572,415],{"class":268},[116,574,575],{"class":196},"huggingface",[116,577,272],{"class":268},[116,579,422],{"class":268},[116,581,582,584,586,588,590],{"class":118,"line":485},[116,583,564],{"class":268},[116,585,429],{"class":196},[116,587,272],{"class":268},[116,589,412],{"class":268},[116,591,399],{"class":268},[116,593,595,598,600,602,604,606,609],{"class":118,"line":594},9,[116,596,597],{"class":268},"                \"",[116,599,465],{"class":196},[116,601,272],{"class":268},[116,603,412],{"class":268},[116,605,415],{"class":268},[116,607,608],{"class":196},"Qwen\u002FQwen3-1.7B",[116,610,278],{"class":268},[116,612,614],{"class":118,"line":613},10,[116,615,616],{"class":268},"            }\n",[116,618,620],{"class":118,"line":619},11,[116,621,622],{"class":268},"        }\n",[116,624,626],{"class":118,"line":625},12,[116,627,482],{"class":268},[116,629,631],{"class":118,"line":630},13,[116,632,488],{"class":268},[11,634,636],{"id":635},"_4-运行时资源问题","4. 运行时资源问题",[16,638,640],{"id":639},"记忆加载失败-schema-mismatch","记忆加载失败 (Schema Mismatch)",[21,642,643,645,646,649],{},[24,644,26],{},"：\n",[29,647,648],{},"mem_cube.load()"," 报错，通常是因为 JSON 文件结构与当前代码版本不兼容。",[21,651,652,654],{},[24,653,91],{},"：\n重新初始化 MemCube 并覆盖旧数据（注意数据丢失风险）：",[107,656,658],{"className":380,"code":657,"language":382,"meta":112,"style":112},"try:\n    mem_cube.load(\"memory_dir\")\nexcept Exception:\n    logger.warning(\"Loading failed, initializing new memory cube\")\n    mem_cube = GeneralMemCube(config)\n    # 谨慎操作：这会覆盖旧数据\n    mem_cube.dump(\"memory_dir\")\n",[29,659,660,669,694,704,725,741,746],{"__ignoreMap":112},[116,661,662,666],{"class":118,"line":119},[116,663,665],{"class":664},"s7zQu","try",[116,667,668],{"class":268},":\n",[116,670,671,674,677,681,684,686,689,691],{"class":118,"line":125},[116,672,673],{"class":264},"    mem_cube",[116,675,676],{"class":268},".",[116,678,680],{"class":679},"s2Zo4","load",[116,682,683],{"class":268},"(",[116,685,272],{"class":268},[116,687,688],{"class":196},"memory_dir",[116,690,272],{"class":268},[116,692,693],{"class":268},")\n",[116,695,696,699,702],{"class":118,"line":131},[116,697,698],{"class":664},"except",[116,700,701],{"class":192}," Exception",[116,703,668],{"class":268},[116,705,706,709,711,714,716,718,721,723],{"class":118,"line":137},[116,707,708],{"class":264},"    logger",[116,710,676],{"class":268},[116,712,713],{"class":679},"warning",[116,715,683],{"class":268},[116,717,272],{"class":268},[116,719,720],{"class":196},"Loading failed, initializing new memory cube",[116,722,272],{"class":268},[116,724,693],{"class":268},[116,726,727,730,732,735,737,739],{"class":118,"line":438},[116,728,729],{"class":264},"    mem_cube ",[116,731,269],{"class":268},[116,733,734],{"class":679}," GeneralMemCube",[116,736,683],{"class":268},[116,738,429],{"class":679},[116,740,693],{"class":268},[116,742,743],{"class":118,"line":460},[116,744,745],{"class":202},"    # 谨慎操作：这会覆盖旧数据\n",[116,747,748,750,752,755,757,759,761,763],{"class":118,"line":479},[116,749,673],{"class":264},[116,751,676],{"class":268},[116,753,754],{"class":679},"dump",[116,756,683],{"class":268},[116,758,272],{"class":268},[116,760,688],{"class":196},[116,762,272],{"class":268},[116,764,693],{"class":268},[16,766,768],{"id":767},"gpu-显存不足","GPU 显存不足",[21,770,771,773,774,777],{},[24,772,91],{},"：\n使用 ",[29,775,776],{},"CUDA_VISIBLE_DEVICES"," 指定显卡，或切换更小的模型（如 0.5B\u002F1.5B 版本）。",[107,779,781],{"className":380,"code":780,"language":382,"meta":112,"style":112},"import os\nos.environ[\"CUDA_VISIBLE_DEVICES\"] = \"0\"\n",[29,782,783,791],{"__ignoreMap":112},[116,784,785,788],{"class":118,"line":119},[116,786,787],{"class":664},"import",[116,789,790],{"class":264}," os\n",[116,792,793,796,798,802,805,807,809,811,814,817,819,822],{"class":118,"line":125},[116,794,795],{"class":264},"os",[116,797,676],{"class":268},[116,799,801],{"class":800},"swJcz","environ",[116,803,804],{"class":268},"[",[116,806,272],{"class":268},[116,808,776],{"class":196},[116,810,272],{"class":268},[116,812,813],{"class":268},"]",[116,815,816],{"class":268}," =",[116,818,415],{"class":268},[116,820,821],{"class":196},"0",[116,823,278],{"class":268},[11,825,827],{"id":826},"_5-用户管理常见问题","5. 用户管理常见问题",[21,829,830,832,833,836],{},[24,831,26],{},"：\n调用 ",[29,834,835],{},"get_user"," 返回 None 或报错。",[21,838,839,841],{},[24,840,91],{},"：\nMemOS 需要明确的用户注册流程。",[107,843,845],{"className":380,"code":844,"language":382,"meta":112,"style":112},"# 1. 注册 MemCube 到特定用户\nmos.register_mem_cube(cube_path=\"path\", user_id=\"user_id\", cube_id=\"cube_id\")\n\n# 2. 创建或获取用户\ntry:\n    # 尝试创建用户\n    user_id = mos.create_user(user_name=\"john\", role=UserRole.USER)\nexcept ValueError:\n    # 如果用户已存在，则获取\n    user = mos.user_manager.get_user_by_name(\"john\")\n",[29,846,847,852,908,914,919,925,930,976,985,990],{"__ignoreMap":112},[116,848,849],{"class":118,"line":119},[116,850,851],{"class":202},"# 1. 注册 MemCube 到特定用户\n",[116,853,854,857,859,862,864,868,870,872,875,877,880,883,885,887,890,892,894,897,899,901,904,906],{"class":118,"line":125},[116,855,856],{"class":264},"mos",[116,858,676],{"class":268},[116,860,861],{"class":679},"register_mem_cube",[116,863,683],{"class":268},[116,865,867],{"class":866},"sHdIc","cube_path",[116,869,269],{"class":268},[116,871,272],{"class":268},[116,873,874],{"class":196},"path",[116,876,272],{"class":268},[116,878,879],{"class":268},",",[116,881,882],{"class":866}," user_id",[116,884,269],{"class":268},[116,886,272],{"class":268},[116,888,889],{"class":196},"user_id",[116,891,272],{"class":268},[116,893,879],{"class":268},[116,895,896],{"class":866}," cube_id",[116,898,269],{"class":268},[116,900,272],{"class":268},[116,902,903],{"class":196},"cube_id",[116,905,272],{"class":268},[116,907,693],{"class":268},[116,909,910],{"class":118,"line":131},[116,911,913],{"emptyLinePlaceholder":912},true,"\n",[116,915,916],{"class":118,"line":137},[116,917,918],{"class":202},"# 2. 创建或获取用户\n",[116,920,921,923],{"class":118,"line":438},[116,922,665],{"class":664},[116,924,668],{"class":268},[116,926,927],{"class":118,"line":460},[116,928,929],{"class":202},"    # 尝试创建用户\n",[116,931,932,935,937,940,942,945,947,950,952,954,957,959,961,964,966,969,971,974],{"class":118,"line":479},[116,933,934],{"class":264},"    user_id ",[116,936,269],{"class":268},[116,938,939],{"class":264}," mos",[116,941,676],{"class":268},[116,943,944],{"class":679},"create_user",[116,946,683],{"class":268},[116,948,949],{"class":866},"user_name",[116,951,269],{"class":268},[116,953,272],{"class":268},[116,955,956],{"class":196},"john",[116,958,272],{"class":268},[116,960,879],{"class":268},[116,962,963],{"class":866}," role",[116,965,269],{"class":268},[116,967,968],{"class":679},"UserRole",[116,970,676],{"class":268},[116,972,973],{"class":800},"USER",[116,975,693],{"class":268},[116,977,978,980,983],{"class":118,"line":485},[116,979,698],{"class":664},[116,981,982],{"class":192}," ValueError",[116,984,668],{"class":268},[116,986,987],{"class":118,"line":594},[116,988,989],{"class":202},"    # 如果用户已存在，则获取\n",[116,991,992,995,997,999,1001,1004,1006,1009,1011,1013,1015,1017],{"class":118,"line":613},[116,993,994],{"class":264},"    user ",[116,996,269],{"class":268},[116,998,939],{"class":264},[116,1000,676],{"class":268},[116,1002,1003],{"class":800},"user_manager",[116,1005,676],{"class":268},[116,1007,1008],{"class":679},"get_user_by_name",[116,1010,683],{"class":268},[116,1012,272],{"class":268},[116,1014,956],{"class":196},[116,1016,272],{"class":268},[116,1018,693],{"class":268},[1020,1021,1022],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}",{"title":112,"searchDepth":125,"depth":125,"links":1024},[1025,1029,1032,1036,1040],{"id":13,"depth":125,"text":14,"children":1026},[1027,1028],{"id":18,"depth":131,"text":19},{"id":149,"depth":131,"text":150},{"id":295,"depth":125,"text":296,"children":1030},[1031],{"id":299,"depth":131,"text":300},{"id":373,"depth":125,"text":374,"children":1033},[1034,1035],{"id":377,"depth":131,"text":377},{"id":491,"depth":131,"text":491},{"id":635,"depth":125,"text":636,"children":1037},[1038,1039],{"id":639,"depth":131,"text":640},{"id":767,"depth":131,"text":768},{"id":826,"depth":125,"text":827},"md",{},"\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fcommon_errors_solutions",{"title":5,"description":112},"cn\u002Fopen_source\u002Fbest_practice\u002Fcommon_errors_solutions","bhUDjhvHzSvWSUgAHGZqQHhc9takooj76nJ6PCr0teY",[1048,1056],{"title":1049,"path":1050,"stem":1051,"icon":1052,"framework":6,"module":6,"class":1053,"target":-1,"active":1054,"defaultOpen":1054,"children":-1,"description":1055},"网络问题解决方案","\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fnetwork_workarounds","open_source\u002Fbest_practice\u002Fnetwork_workarounds","i-ri-wifi-line",[],false,"以下是一些在开发过程中可能遇到的网络问题的应对方案。",{"title":1057,"path":1058,"stem":1059,"icon":1060,"framework":6,"module":6,"class":1061,"target":-1,"active":1054,"defaultOpen":1054,"children":-1,"description":-1},"MemOS MCP集成指南","\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fmcp_for_cozespace_and_tools","open_source\u002Fbest_practice\u002Fmcp_for_cozespace_and_tools","i-ri-tools-line",[],1774339752634]