记忆宫殿 Memory Palace

给 Claude Code 用的长期记忆系统。纯 shell + SQLite，零外部依赖，装完即用。

解决什么问题

Claude Code 聊久了会自动压缩上下文——你的 Agent 突然忘了刚才在做什么、做了什么决定、进度到哪了。记忆宫殿让这件事不再发生：

1. 压缩不丢进度 — 压缩前后自动保存和恢复状态，Agent 像没事一样继续干活
2. 记忆不重复 — 同一个话题聊 8 次不会存 8 条相似记录，自动识别合并
3. 信息连成网 — 记忆之间自动建立关联，搜一条能顺藤摸瓜找到相关的几条

安装

curl -fsSL https://raw.githubusercontent.com/Tino-Tian/-Memory-Palace-AI-/main/install.sh | bash

一行命令。自动装 sqlite3、建数据库、配置 Claude Code hooks。Windows 用户用 install.ps1。

能做什么

草稿纸

Agent 把当前状态持续写到一个磁盘文件上，不受上下文压缩影响。即使 Claude 内部清空了，文件还在。

压缩前 → 自动拍照存档
压缩中 → Claude 清空上下文  
压缩后 → 自动把关键信息塞回 Agent 眼前

自动归类

不是关键词匹配。Agent 像人一样读懂对话内容，沿类目树逐层递归，找到最合适的分类。现有类目装不下就自动创建。分类体系跟着你的聊天内容自然生长。

工作
├── 开发
│   ├── 前端
│   └── 后端
├── 运营
│   └── 旅拍招商    ← 自动创建的
└── ...

三层嗅探

层级	什么时候触发	做什么
第一层	每轮都做	看一眼草稿纸，确认当前焦点和进度
第二层	你提到项目名/关键词	搜数据库历史记忆
第三层	深度讨论某个领域	主动查该领域最近记忆，发现隐性关联

知识图谱

记忆之间自动建立关系——"A 触发 B""B 参考了 A 的结论""C 延续了 B 的讨论"。检索时沿图谱链上下游各走一步，不再只搜到孤立的结果。

自动去重

写入新记忆前，自动检查是否跟已有记录相似。关键词重合度超过 60% 就合并而非新建，数据库不会堆满同一话题的重复记录。

结构化提取

Agent 归档时自动从对话中提取结构化信息，统一 JSON 格式存储：

{
  "决定": ["用方案A替代方案B"],
  "数字": {"预算": 5000, "预计时间": "2小时"},
  "偏好": ["禁止弹窗"],
  "关键结论": "草稿纸不加速压缩"
}

想看"我做过哪些决定"直接查这个字段，不用翻大段文字。

时间衰减

模拟人脑遗忘曲线。近期记忆保留完整细节，远期记忆浓缩为核心结论，超 7 天的压缩归档但永久可搜索。

手动命令

命令	作用
/宫殿 查找 <关键词>	搜索历史记忆（含归档）
/宫殿 状态	查看数据库统计
/宫殿 树	查看完整类目树
/宫殿 类目 <路径>	查看指定类目下的记忆

跟其他方案比

能力	Mem0	Zep	Letta	agentmemory	记忆宫殿
基础记忆存取	✅	✅	✅	✅	✅
时间衰减	✅	✅	✅	❌	✅
全文搜索	✅	✅	✅	✅	✅
压缩恢复	❌	❌	❌	❌	✅
知识图谱	✅	❌	❌	❌	✅
自动去重	✅	✅	❌	❌	✅
结构化提取	✅	❌	❌	❌	✅
零外部依赖	❌	❌	❌	❌	✅

记忆宫殿不做的事：向量语义搜索。对一个人用、分类清晰的场景，FTS5 全文搜索就够了。如果将来需要，加一行 pip install 就能补上——这不改变核心优势。

设计选择

别人的做法	这里的做法
MCP 服务器，需要 Python/Node/Rust 运行时	纯 shell + SQLite，零依赖
比谁检索更快（LongMemEval 跑分）	先解决压缩后失忆这个更根本的问题
通用方案，适配所有 AI 平台	专为 Claude Code 深度定制
API 调用提取记忆，每次花 token	hooks 时机复用，Agent 自己记，不额外消耗
多人多 AI 共享记忆	一个人、一个 AI、一份记忆

使用方式

全自动（不需要操作）：启动时加载最近 24 小时记忆索引，聊天中自动嗅探历史关联，压缩时自动保存和恢复，结束时分拆话题、智能归类、写入数据库。

手动命令：/宫殿 查找|状态|树|类目 按需查询。

使用成本

项目	每次	一年
启动索引 + 草稿纸恢复	~430 token	~47 万
压缩恢复	~300 token	~11 万
对话中嗅探 + 归档	~80 token	~10 万
一年总计		约 68 万 token

按 Claude API 定价约 $2–10/年。对比每次重述背景花 200–500 token，记忆宫殿省下的远超过自身消耗。

磁盘占用约 1–2 MB/年。

隐私

所有数据存于本地 palace.db，不联网不上传。.gitignore 已忽略数据库和归档文件。随时删除 palace.db 和 归档/ 清空所有记忆。

协议

MIT — 自由使用、修改、分发。