9.7 万星开源记忆引擎，AI 编程助手再也不失忆

每次关掉会话，AI 就忘了你交代过什么？这个 9.7 万星的开源项目，专门给 AI 编程助手装长期记忆。

📌 项目名片

🤔 它解决什么问题

用 AI 编程助手的人几乎都遇到过同一个痛点：换个会话，等于换了个陌生人。

你花半小时跟它讲清楚项目结构、约定、踩过的坑，辛辛苦苦调通一个 bug、定下一个命名规范。结果第二天新开一个窗口，它又一脸茫然地问你「这个项目是干嘛的」。上下文一断，之前的沟通成本全部作废。

传统做法无非两种：要么把关键信息手动写进 CLAUDE.md、.cursorrules 这类配置文件，费时费力还容易漏；要么靠工具自带的「项目记忆」，覆盖面窄、也不会自己沉淀。

这个项目的思路不一样：它不依赖你手动记录，而是像个随行秘书，静静记下你跟 AI 的每一次交互，再用 AI 自动压缩成摘要存起来。等你开启下次会话，它只把「相关的那部分记忆」塞回上下文里，既不塞爆 token，又能让 AI 接着上次的活儿干。

✨ 核心亮点

🧠 自动捕获，全程不用你操心

它通过 5 个生命周期钩子（SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd）挂在 Claude Code 等工具上。你做的每一次操作、AI 的每一次观察，都会被自动捞进来，无需手动触发。

📊 分层检索，token 能省 10 倍

记忆不是一股脑全塞给你，而是走「三层工作流」：先用 search 拿精简索引（每条约 50–100 token），再用 timeline 看时间线上下文，最后才用 get_observations 拉取需要的完整细节。先过滤再取全文，比乱翻记忆库省约 10 倍 token。

🔀 混合检索，关键词 + 语义都能找

底层是 SQLite（配 FTS5 全文索引）+ Chroma 向量库。既能按关键词精确命中，又能按语义模糊联想，比如问「身份验证的 bug」也能捞出相关的历史记录。

🔌 不止 Claude Code，一家通吃

虽然名字里带 Claude，但它其实支持一大票 AI 编程工具：Claude Code、Codex、Gemini、OpenCode、T3 Code、Pi、DeepSeek Harness 等。装一次，多端通用。

🔒 隐私可控，敏感内容可排除

担心记忆库存了不该存的东西？在内容上用 <private> 标签标记即可排除，且有本地 worker + 网页查看器，能看到每条记忆从哪来、什么时候记下的。

🚀 快速上手

安装只需一条命令：

npx claude-mem install

或者在 Claude Code 的插件市场里装：

/plugin marketplace add thedotmack/claude-mem /plugin install claude-mem

重启之后，之前会话的上下文会自动出现在新会话里，基本零配置。想用中文记忆模式，在 ~/.claude-mem/settings.json 里设一句：

{ "CLAUDE_MEM_MODE": "code--zh" }

👥 适合谁

需要提醒一句：本地记忆能力虽强，但换机器后要自己迁移本地存储的数据（或接入它的 Cloud Sync），重度跨设备使用前值得先看看文档。

💡 小结

给 AI 装「长期记忆」这件事，已经从「手动维护配置」进化到了「自动捕获、自动压缩、按需召回」。如果你受够了每次重开对话都要重新自我介绍，值得点个 star 试试。

👉 想看完整架构和配置细节？打开仓库原文继续读。