MemPalace 是一个本地优先的 AI 记忆系统，用于为 Claude Code 或其他 LLM 智能体提供持久记忆。它逐字存储对话历史与项目内容，不做摘要、改写或有损压缩，核心操作默认不调用外部 API。检索采用 BM25 与语义混合搜索，官方称在 LongMemEval 上 R@5 达 96.6%（无 LLM 参与）。
主要用途：为 Claude Code 会话建立持久记忆；挖掘项目文件（mempalace mine）或 Claude Code 对话记录（--mode convos）；检索过往会话中遗忘的上下文（mempalace search、wake-up）；配置自动保存钩子，使会话在上下文压缩后仍可恢复；安装配置 MCP 服务器（29 个 palace 工具）；管理知识图谱（实体、谓词、时间关系）；回填已有的 ~/.claude/projects/ JSONL 记录；修复、去重或迁移 palace；编写自定义存储后端或切换嵌入模型；复现或扩展记忆基准测试。
架构上，palace 分为 WING（大类，如人物、项目、主题）→ ROOM（按时间分组，如天、会话）→ DRAWER（逐字文本块）。索引层使用 AAAK 方言压缩指针指向 DRAWER 位置；知识图谱存于 SQLite，形式为 ENTITY → PREDICATE → ENTITY，带 valid_from / valid_to 日期。记忆分四层：L0 约 100 token 常驻身份信息，L1 约 500–800 token 常驻核心故事，L2 按需加载主题内容，L3 按需进行完整 ChromaDB 语义搜索。mempalace wake-up 加载 L0+L1（约 600–900 token）。
安装：uv tool install mempalace，或 pipx install mempalace，或在已激活的 venv 中 pip install mempalace。需要 Python 3.9+，默认后端为 ChromaDB（嵌入模型约 300 MB）。首次运行配置：python -m mempalace.onboarding。
常用命令：mempalace init ~/projects/myapp 初始化；mempalace mine ~/projects/myapp 挖掘项目文件；mempalace mine ~/.claude/projects/ --mode convos 挖掘对话记录；mempalace sweep 按消息粒度存储（幂等、可续跑）；mempalace search "查询" 搜索；mempalace wake-up 加载记忆上下文；mempalace status 查看概览；mempalace hook install 安装 Stop 与 PreCompact 钩子；mempalace repair、mempalace migrate 用于维护。MCP 服务器通过 mempalace mcp 启动。
设计原则：始终逐字保存；仅增量追加；以实体为先；本地优先，BYOK 需显式启用；钩子性能预算 <500ms，启动注入 <100ms。限制方面，资料未提供收费、价格与平台支持等细节；自定义后端需继承 mempalace/backends/base.py 并注册。