README_CN.md

在项目根目录创建 .vscode/mcp.json：

{
  "servers": {
    "mem-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/memovai/memov.git",
        "mem-mcp-launcher",
        "stdio",
        "${workspaceFolder}"
      ]
    }
  }
}

进入 Files > Preferences > Cursor Settings > MCP，添加：

{
  "mcpServers": {
    "mem-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/memovai/memov.git",
        "mem-mcp-launcher",
        "stdio",
        "${workspaceFolder}"
      ]
    }
  }
}

注意: Antigravity 不支持 "${workspaceFolder}" 变量，请手动填写项目目录的绝对路径。

前往 Settings > MCP，然后添加：

{
  "mcpServers": {
    "mem-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/memovai/memov.git",
        "mem-mcp-launcher",
        "stdio",
        "/absolute/path/to/your/project"
      ]
    }
  }
}

将 /absolute/path/to/your/project 替换为项目目录的实际绝对路径（例如 macOS/Linux 上 /Users/username/projects/my-project 或 Windows 上 C:\Users\username\projects\my-project）。

要启用语义搜索、验证和调试工具，使用 [rag] 扩展安装：

Claude Code:

claude mcp add mem-mcp --scope project -- uvx --from "git+https://github.com/memovai/memov.git[rag]" mem-mcp-launcher stdio $(pwd)

VS Code / Cursor: 将 --from 参数改为：

"git+https://github.com/memovai/memov.git[rag]"

brew tap memovai/mem
brew install memov

echo "deb [trusted=yes] https://memovai.github.io/memov/apt stable main" | sudo tee /etc/apt/sources.list.d/mem.list
sudo apt update
sudo apt install mem

sudo curl -o /etc/yum.repos.d/mem.repo https://memovai.github.io/memov/yum/mem.repo
sudo dnf install mem

下载适合你平台的最新版本：

需要 Python 3.10+ 和 uv：

git clone https://github.com/memovai/memov.git
cd memov
uv sync
uv pip install -e .
mem --help

核心操作

• snap(user_prompt: str, original_response: str, agent_plan: list[str], files_changed: str)

  • 记录每次用户交互，自动追踪文件。智能处理未追踪和已修改的文件。

• mem_ui(port: int = 38888)

  • 在 http://localhost:38888 启动 Web 界面，可视化浏览历史、查看差异和跳转到任意快照。

• mem_history(limit: int = 20, commit_hash: str = "")

  • 查看 memov 历史，包括提示词、响应和文件更改。

• mem_jump(commit_hash: str)

  • 跳转到指定快照，恢复所有追踪的文件并创建新分支。

RAG 工具（需要 [rag] 扩展）

这些工具仅在使用 [rag] 扩展安装时可用。

• mem_sync()

  • 将所有待处理操作同步到向量数据库，启用语义搜索功能。

• validate_commit(commit_hash: str, detailed: bool = True)

  • 通过比较提示词/响应与实际代码更改来验证特定提交。检测上下文漂移和对齐问题。

• validate_recent(n: int = 5)

  • 验证最近 N 次提交的对齐模式。适用于会话审查和质量保证。

• vibe_debug(query: str, error_message: str = "", stack_trace: str = "", user_logs: str = "", models: str = "", n_results: int = 5)

  • 使用 RAG 搜索 + 多模型 LLM 比较进行调试。搜索代码历史获取相关上下文，并行查询多个 AI 模型（GPT-4、Claude、Gemini）获取多样化的调试见解。

• vibe_search(query: str, n_results: int = 5, content_type: str = "")

  • 快速语义搜索代码历史（提示词、响应、代理计划、代码更改），无需 LLM 分析。适合快速上下文查找。

健康检查

• GET /health
  • 返回 "OK"。用于 IDE/代理就绪检查。