夜雨聆风学习资料网

ARTICLE · 1178336

14个月10万星:让AI编程助手记住每个会话

14个月10万星:让AI编程助手记住每个会话

01 它是什么

thedotmack/claude-mem,当前 100044 star、8776 fork。给 AI 编程助手装持久记忆的开源插件,TypeScript 编写:自动捕获会话里代理做过的每件事,压缩成语义摘要,新会话自动注回相关上下文。本体是插件加本地后台服务,支持 Claude Code、OpenCode、Codex、Cursor 等多款工具——注意 `npm install -g` 只装 SDK 库,装插件要走 `npx claude-mem install` 或插件市场命令。

02 痛点:会话一关,记忆清零

AI 编程助手的工作单元是一次会话:昨天排查过的 bug、定下的方案、踩过的坑,会话一关即归零。新会话得重新交代项目背景——费时间,也费 token。上下文窗口再大,也装不下一整个项目的协作史。

03 机制:钩子捕获,三层检索

五个生命周期钩子挂在会话流程上:启动、用户提交、工具执行后、响应结束、会话结束,把工具调用的观察送到本地后台服务。存储用 SQLite(全文检索)加 Chroma 向量库做混合检索。读取端是三层渐进式工作流:先 search 拿紧凑索引,每条约 50 到 100 token;再看 timeline 补时间线上下文;确认相关后才用 get_observations 取全文,每条约 500 到 1000 token。先过滤后取详情,官方口径节省约十倍 token。摘要语言可配置,简体中文模式内置。

04 成本与效果

Apache-2.0 协议,仓库创建于 2025 年 8 月底,约十四个月收获十万星,当前快照日均增速约 240;npm 月下载 6.6 万。免费档可回落自有 Anthropic 额度,也可填 OpenRouter 或 Gemini 的 key;托管版 CMEM Pro 提供 30 天试用。数据本地 SQLite 存储,敏感内容可用 private 标签排除。

05 上手:一条命令

在 Claude Code 里执行插件市场命令即可安装,重启后上一会话的上下文自动出现在新会话里;另有网页查看器实时翻阅记忆流。依赖多数自动补齐,要求 Node 20 以上。

06 适合谁

· 长期维护同一项目的 Claude Code 与 OpenCode 用户· 多会话并行开发、希望助手记住历史决策与踩坑记录的工程师· 在意 token 开销、需要精准控制上下文注入的团队· 想研究代理记忆系统架构的开发者——钩子捕获加混合检索是套可参考的完整实现

相关学习资料