MemPalace/mempalace skill 本地安装使用教程(新手)

看到 MemPalace/mempalace，不要把它理解成又一个会总结聊天记录的云记忆服务。README 写得很清楚：它保存原文，用语义搜索找回，默认本地优先，除非你主动选择外部后端。

这个 skill 教程适合想给 Claude Code、Gemini CLI、Antigravity 或 MCP 工具补长期上下文的人。新手先跑 mine、search、wake-up 三步，不要一上来就换 Qdrant、pgvector 或 GPU 镜像。

安装先用 uv tool，避开全局 Python 冲突

MemPalace 官方推荐用 uv tool install 安装 CLI，这样依赖会放进隔离环境，减少 Debian、Ubuntu、Homebrew Python 上的 PEP 668 和依赖冲突。

uv tool install mempalace
mempalace init ~/projects/myapp

如果你习惯 pipx，也可以用 pipx install mempalace。普通 pip install 更适合已经激活虚拟环境、并且明确需要在代码里 import mempalace 的场景。

第一次只挖一个目录

先选一个小项目目录，把文件写入 palace，再搜索一个你知道答案的问题。Claude Code 会话可以用 convos 模式挖 ~/.claude/projects/，并用 --wing 按项目缩小范围。

mempalace mine ~/projects/myapp
mempalace mine ~/.claude/projects/ --mode convos
mempalace search "why did we switch to GraphQL"
mempalace wake-up

Docker 主要给 MCP 和免 Python 环境用

不想在本机装 Python 工具链，可以构建 Docker 镜像。MCP stdio 方式要保留 -i，因为 JSON-RPC 需要标准输入；数据、配置和缓存模型建议挂到 /data。

docker build -t mempalace .
docker run -i --rm -v mempalace-data:/data mempalace
docker run --rm -v mempalace-data:/data -v /path/to/project:/work mempalace mine /work

外部后端不要当默认开关

默认 ChromaDB 已能完成本地记忆。sqlite_exact 适合做本地正确性检查；Qdrant 和 pgvector 是显式选择，指向外部服务时，原文 drawer 文本和元数据会发到那个服务。先把本地闭环跑通，再决定是否引入外部后端，才符合 MemPalace 的本地优先边界。

读完后先别急着接复杂客户端：用一个小项目完成 mine、search、wake-up，确认旧决策能被找回，再接 Claude Code 或 Docker MCP。能找回原文上下文，MemPalace 才算装到了该发挥作用的位置。