社区 › 科技 › Claude-Mem：给 AI 编程助手装上"长期记忆"

焦尔蕾 发表于 2026-1-26 19:40:03

Claude-Mem：给 AI 编程助手装上"长期记忆"

<h2 id="写在前面">写在前面</h2>
<p>你是不是也遇到过这种情况：昨天用 Claude Code 写了一段复杂业务逻辑，今天重新打开项目，AI 助手却像失忆了一样，完全不记得你们讨论过什么，只能从头再解释一遍？</p>
<p>这个痛点，Claude-Mem 给出了解决方案——一个专为 Claude Code 打造的持久化记忆系统，让 AI 助手真正记住你们的每一次协作。</p>
<p></p>

<h2 id="它到底解决了什么问题">它到底解决了什么问题</h2>
<p>传统的 AI 编程助手每次启动都是"全新的大脑"，无法跨会话保留项目上下文。Claude-Mem 通过自动捕获、AI 压缩、智能检索三个步骤，实现了：</p>
<ul>
<li>✅ <strong>跨会话记忆保持</strong>：自动记录所有工具调用和代码操作</li>
<li>✅ <strong>智能内容压缩</strong>：用 Claude Agent SDK 将冗长对话压缩成精炼摘要</li>
<li>✅ <strong>按需精准检索</strong>：通过自然语言查询历史记忆，大幅节省 Token 成本</li>
</ul>

<h2 id="技术架构解析">技术架构解析</h2>
<p><strong>核心组件构成</strong></p>
系统架构：
├── 钩子系统（7 个生命周期钩子）
├── Worker 服务（HTTP API + Web UI）
├── 存储层（SQLite FTS5 + Chroma 向量库）
└── PM2 进程管理
<p><strong>主要技术栈</strong>：</p>
<ul>
<li><strong>Node.js + TypeScript</strong>：插件主体实现</li>
<li><strong>SQLite FTS5</strong>：全文检索引擎</li>
<li><strong>Chroma Vector DB</strong>：语义向量搜索</li>
<li><strong>Claude Agent SDK</strong>：AI 压缩核心能力</li>
</ul>

<h2 id="工作原理拆解">工作原理拆解</h2>
<p><strong>五大生命周期钩子</strong></p>
<p>Claude-Mem 采用观察者模式，在不干扰主会话的前提下，通过钩子捕获关键事件：</p>
<table>
<thead>
<tr>
<th>钩子名称</th>
<th>触发时机</th>
<th>核心作用</th>
</tr>
</thead>
<tbody>
<tr>
<td>context-hook</td>
<td>会话启动时</td>
<td>注入最近记忆作为上下文</td>
</tr>
<tr>
<td>new-hook</td>
<td>用户提问时</td>
<td>创建新会话并保存提示词</td>
</tr>
<tr>
<td>save-hook</td>
<td>工具执行后</td>
<td>捕获文件读写等操作记录</td>
</tr>
<tr>
<td>summary-hook</td>
<td>会话结束时</td>
<td>生成 AI 摘要并持久化存储</td>
</tr>
<tr>
<td>cleanup-hook</td>
<td>停止指令时</td>
<td>清理临时数据</td>
</tr>
</tbody>
</table>
<p><strong>渐进式披露策略</strong></p>
<p>这是 Claude-Mem 最巧妙的设计——不是一股脑把所有历史记录塞给 AI，而是分层展示：</p>
Level 1: 最近 3 条会话摘要（约 500 tokens）
Level 2: 相关观察记录（用户主动查询）
Level 3: 完整历史检索（mem-search 技能）
<p>这种策略借鉴了前端开发中的懒加载思想，在云栈社区的技术实践中，我们也常强调"按需加载"的性能优化原则。</p>

<h2 id="实际应用场景">实际应用场景</h2>
<p><strong>场景一：Bug 修复追溯</strong></p>
用户："上周修复的登录超时问题，具体改了哪些文件？"
Claude：[自动触发 mem-search]
       → 检索到 2 条相关观察记录
       → 返回：修改了 auth.ts 和 session.middleware.ts
<p><strong>场景二：项目知识库构建</strong></p>
<p>长期使用后，Claude-Mem 会自动构建项目的"知识图谱"：</p>
<ul>
<li>架构决策记录</li>
<li>常用代码模式</li>
<li>踩过的坑和解决方案</li>
</ul>
<p><strong>场景三：团队协作可视化</strong></p>
<p>通过 Web UI（localhost:37777）可以实时查看：</p>
<ul>
<li>记忆流动态</li>
<li>会话摘要时间线</li>
<li>Token 消耗统计</li>
</ul>

<h2 id="快速上手指南">快速上手指南</h2>
<p><strong>安装步骤（3 步完成）</strong></p>
# 在 Claude Code 终端执行
> /plugin marketplace add thedotmack/claude-mem
> /plugin install claude-mem
# 重启 Claude Code 即可使用
<p><strong>核心技能使用</strong></p>
<p><strong>mem-search 技能</strong>：自然语言查询历史记忆</p>
示例：mem-search "关于数据库迁移的讨论"
效果：相比传统 MCP 方式节省约 2,250 tokens

<h2 id="架构设计亮点">架构设计亮点</h2>
<p><strong>混合检索策略</strong></p>
// 结合传统全文检索和现代向量搜索
interface SearchStrategy {
  fullText: SQLite FTS5,     // 关键词精准匹配
  semantic: Chroma Vector,   // 语义相似度计算
  hybrid: RRF 融合排序       // 最佳结果输出
}
<p><strong>隐私控制机制</strong></p>
<p>使用 <code><private></code> 标签排除敏感内容：</p>
<private>
API_KEY=sk-xxx  # 不会被系统记录
</private>
<p><strong>双标签系统（v7.0 新特性）</strong></p>
<ul>
<li><code><private></code>：完全排除观察记录</li>
<li><code><no-summary></code>：记录但不生成摘要</li>
</ul>

<h2 id="性能表现数据">性能表现数据</h2>
<table>
<thead>
<tr>
<th>优化指标</th>
<th>实际效果</th>
</tr>
</thead>
<tbody>
<tr>
<td>Token 节省</td>
<td>每次启动节省 2,250 tokens</td>
</tr>
<tr>
<td>查询响应速度</td>
<td>向量检索 < 50ms</td>
</tr>
<tr>
<td>存储压缩效率</td>
<td>10GB 代码库压缩至约 200MB</td>
</tr>
</tbody>
</table>

<h2 id="工程实践启示">工程实践启示</h2>
<p>作为全栈工程师，Claude-Mem 展示了几个值得学习的工程实践：</p>
<ol>
<li><strong>插件化设计</strong>：标准的生命周期钩子系统</li>
<li><strong>AI 工程化</strong>：将 LLM 能力封装为可复用服务</li>
<li><strong>成本意识</strong>：Token 优化是 AI 原生应用的核心指标</li>
<li><strong>用户体验</strong>：渐进式披露配合可视化 UI</li>
</ol>
<p>对于想深入学习 Node.js 开发和 人工智能应用的朋友，这个项目提供了很好的参考范例。</p>

<h2 id="写在最后">写在最后</h2>
<p>Claude-Mem 不仅是一个工具，更是 AI 辅助编程的范式探索：如何让 AI 从"一次性对话"进化为"长期协作伙伴"。</p>
<p>如果你正在使用 Claude Code，不妨试试这个插件，让你的 AI 助手真正"记住"你们的每一次协作。更多优质开源项目解析，欢迎关注《云栈开源日记》！</p>

<h3 id="项目资源">项目资源</h3>
<ul>
<li><strong>GitHub 仓库</strong>：<code>thedotmack/claude-mem</code></li>
<li><strong>官方文档</strong>：<code>docs.claudemem.com</code></li>
<li><strong>AI 学习</strong>：<code>https://yunpan.plus/f/29</code></li>
<li><strong>TypeScript 学习</strong>：<code>https://yunpan.plus/f/18</code></li>
</ul>

<p>标签：#Claude #GitHub #AI编程助手 #向量数据库 #TypeScript #持久化存储 #开发工具</p>
<p>原文 <code>https://yunpan.plus/t/1920-1-1</code> 版权所有</p><br>来源：程序园用户自行投稿发布，如果侵权，请联系站长删除<br>免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

人弧 发表于 2026-1-27 05:05:29

感谢分享，学习下。

皇甫佳文 发表于 2026-2-1 06:00:50

感谢分享

赴忽 发表于 2026-2-4 09:39:39

谢谢分享，辛苦了

徙办 发表于 2026-2-6 23:44:12

感谢分享，学习下。

曲愍糙 发表于 2026-2-7 21:37:33

感谢分享，下载保存了，貌似很强大

济曝喊 发表于 2026-2-7 23:50:02

喜欢鼓捣这些软件，现在用得少，谢谢分享！

上官泰 发表于 2026-2-8 06:40:16

前排留名，哈哈哈

骆熙华 发表于 2026-2-8 21:07:41

yyds。多谢分享

颖顿庐 发表于 2026-2-9 14:58:18

感谢发布原创作品，程序园因你更精彩

旌磅箱 发表于 2026-2-10 02:21:38

感谢分享，学习下。

杼氖 发表于 2026-2-11 23:45:24

不错，里面软件多更新就更好了

客臂渐 发表于 2026-2-12 06:57:19

前排留名，哈哈哈

汇干环 发表于 2026-2-12 12:01:49

这个有用。

汹萃热 发表于 2026-2-13 10:28:40

谢谢分享，试用一下

查看完整版本: Claude-Mem：给 AI 编程助手装上"长期记忆"