Memdx

🚀 MemDx Memory Layer for Cursor

MemDx是一款强大的VS Code/Cursor扩展程序，它集成了一个本地、私密的内存层（原Mem0），为你的项目提供持久的AI上下文。MemDx能帮助你的AI在不同会话中记住重要决策、代码模式和项目结构。

✨ 主要特性

• 🧠 持久上下文：存储并调取项目决策、规则和架构信息。
• 🔒 100%本地且私密：借助Docker（Qdrant + Ollama）在本地机器上运行，数据不会离开你的设备。
• 🔍 语义搜索：使用自然语言查找相关记忆。
• 🚀 与Cursor Agent集成：通过MCP与Cursor的Agent（Composer）无缝协作。
• ⚡ 零配置设置：内置的设置向导会处理一切。
• 📝 智能索引：一键对README.md、.cursorrules和项目结构进行索引。

🚀 快速开始

1. 前提条件

• 已安装并运行Docker Desktop。
• 安装Node.js（v18+）（用于MCP服务器）。

2. 安装

1. 从应用市场或VSIX安装此扩展程序。
2. 当出现提示时，点击**“立即设置”** 或运行命令MemDx: Quick Setup Wizard。
3. 输入用户ID（例如，你的姓名）和产品ID（你的项目名称）。

3. 使用方法

• 添加记忆：选择代码/文本 -> 右键点击 -> MemDx: Add Memory from Selection。
• 搜索：按下Ctrl+Shift+P -> 输入MemDx: Search Memories -> 输入查询内容（例如，“身份验证逻辑”）。
• 查看所有记忆：按下Ctrl+Shift+P -> 输入MemDx: View All Memories。

📚 详细文档

设置Cursor AI（MCP）集成

要让Cursor的Agent（Composer）自动读写记忆，请按以下步骤操作：

1. 按下Ctrl+Shift+P并运行**MemDx: Copy MCP Config for Cursor**。
2. 打开Cursor设置（齿轮图标） -> 功能 -> MCP。
3. 将配置粘贴到MCP设置编辑器中。
4. 点击添加。

现在，你可以在聊天中输入@MemDx Memory Layer，或者直接向Agent提问，例如：

"将此架构决策保存到记忆中" "我们关于错误处理的决策是什么？搜索记忆。"

命令

配置

你可以在VS Code设置中自定义以下内容：

• memdx.userId：你的唯一标识符。
• memdx.productId：项目标识符（允许按项目分隔记忆）。
• memdx.autoStart：启动时自动启动后端（默认值：false）。

故障排除

"Memories map is not a function" / 向量维度错误

如果你切换了模型或版本，数据库可能存在维度不匹配的问题。 解决方法：运行命令**MemDx: Reset Service (Fix DB)**。这将清除本地Qdrant数据并重新启动。

"Model not found"

首次运行MemDx时，它会在Docker内下载AI模型（qwen2.5、nomic-embed-text），这需要几分钟时间。你可以使用MemDx: Check Service Status检查状态。

服务无法启动

确保Docker Desktop正在运行。你可以使用MemDx: View Service Logs查看详细日志。

MemDx - 你的AI的长期记忆。 最初基于Mem0开发，针对本地开发工作流进行了优化。