Brand LogoBrand Logo (Dark)
首页智能体广场工具包广场GitHub 精选提交智能体博客

分类

  • AI 绘画
  • AI 音频
  • 自动化工具
  • 聊天机器人
  • 编程工具
  • 金融工具

分类

  • 大语言模型
  • 营销工具
  • 零代码/低代码
  • 研究与搜索
  • 视频与动画
  • 视频编辑

GitHub 精选

  • DeerFlow — 字节跳动开源超级智能体框架

最新博客

  • OpenClaw vs Composer 2 Which AI Assistant Delivers More Value
  • Google AI Studio vs Anthropic Console
  • Stitch 2.0 vs Lovable Which AI Design Tool Wins in 2026
  • Monetizing AI for Solopreneurs and Small Teams in 2026
  • OpenClaw vs MiniMax Which AI Assistant Wins in 2026

最新博客

  • OpenClaw vs KiloClaw Is Self-Hosting Still Better
  • OpenClaw vs Kimi Claw
  • GPT-5.4 vs Gemini 3.1 Pro
  • Farewell to Bloomberg Terminal as Perplexity Computer AI Redefines Finance
  • Best Practices for OpenClaw
LinkStartAI© 2026 LinkstartAI. 版权所有。
联系我们关于
  1. 首页
  2. GitHub 精选
  3. claude-mem
claude-mem logo

claude-mem

面向 Claude Code 的持久记忆压缩插件:自动捕获工具调用与会话轨迹,生成可搜索的语义摘要并跨会话注入上下文。
29.7kTypeScriptGNU Affero General Public License v3.0
#typescript#sqlite#chromadb#persistent-memory#semantic-search#mcp
#progressive-disclosure
#memory-compression
#claude-code-plugin
#cursor-workflows
#alternative-to-memorymd
#developer-observability

项目简介

claude-mem 把“开发过程本身”当作可存储、可检索、可回放的资产:它在编码会话中自动捕获 Claude 的工具使用与关键观察,将高噪声轨迹压缩为结构化记忆,并在下一次会话启动时按需注入。核心思路是用钩子把事件流稳定落地,再用索引与语义检索把信息密度拉高,最后用渐进式披露控制token成本,让记忆既能常驻又不会淹没上下文窗口。数据层默认落到 SQLite,并通过全文检索与可选向量库实现“关键词可查、语义可找”;同时提供本地Web Viewer实时观察记忆流,便于调试与复盘。对团队而言,它把个人脑内经验转成可共享的工程记忆:需求变更、踩坑原因、修复路径、命令习惯都能沉淀下来,让跨天、跨分支、跨成员的连续开发不再从零热身。

痛点 vs 创新

✕传统痛点✓创新方案
多次重连或跨天开发时,关键上下文分散在终端输出、Issue、脑内记忆与零碎笔记里,信息密度低且不可回放,导致重复排查与反复解释。claude-mem 用生命周期钩子把工具事件与关键观察稳定收集,再用AI压缩成结构化记忆并落库,让记忆成为可查询的数据而不是不可控的聊天残渣。
把记忆放进单一文本文件时,内容要么太短导致丢细节,要么太长导致每次启动都塞满上下文窗口;而且缺少可检索索引,难以按任务和症状定位。通过全文检索+可选向量检索实现混合搜索,并用渐进式披露按token预算分层拉取上下文;同时提供本地Viewer让记忆流可观测,方便调参和复盘。

架构深度解析

Hook管线:把会话变成事件流
claude-mem 的底层范式是事件驱动:把 Claude Code 的生命周期与工具调用视为离散事件,通过插件钩子在关键节点捕获输入、工具参数与结果。这样做的意义是把“不可复现的交互过程”变成可持久化的事件流,后续无论是压缩、检索还是审计,都建立在同一份原始事实之上。事件先落库再异步处理,避免把AI压缩的延迟耦合到交互主流程,从而保持编码会话的响应性。最终注入阶段只读取高信号摘要而不是原始长日志,让上下文窗口被更少、更准的信息占用。
双索引:FTS5 + 向量检索的混合召回
claude-mem 把“可找回”拆成两类能力:关键词精确检索与语义相似检索。SQLite 的全文检索用于快速定位命令、文件名、错误栈与关键词线索,适合排查与对照;可选的向量库用于跨表述的语义召回,适合你只记得意图却记不住关键字的场景。混合检索的关键在于降低误召回:先用结构化摘要提升信息密度,再用渐进式披露分层返回,让模型在有限token里逐步扩大上下文。配套的Viewer与搜索技能让这套检索路径可观测、可调参,避免变成黑盒记忆。

部署指南

1. 在 Claude Code 中安装插件

bash
1> /plugin marketplace add thedotmack/claude-mem2> /plugin install claude-mem

2. 重启 Claude Code 让插件钩子生效

bash
1exit  # 退出后重新打开 Claude Code

3. 检查本地设置文件并按需调整注入策略

bash
1cat ~/.claude-mem/settings.json

4. 使用 mem-search 技能检索历史会话记忆

bash
1在 Claude Code 中输入自然语言查询,例如:"What did we change in auth?"

5. 打开本地 Viewer 观察实时记忆流(可选)

bash
1open http://localhost:37777

落地场景

核心场景目标人群解决方案最终收益
跨天开发续航独立开发者自动记录工具轨迹与决策并在下一次会话注入关键摘要减少重复排查,快速恢复上次的工作上下文
团队交接与复盘工程团队负责人把会话观察压缩为可搜索记忆并用Viewer检查质量交接成本下降,问题复现与回归验证更可控
Agent工作流审计平台工程师将工具调用与结果沉淀到数据库并用混合检索定位异常路径提升可观测性,缩短定位时间并降低误操作风险

避坑指南

避坑指南
  • 该项目以本地落库与索引为核心,历史数据体量会持续增长;需要结合保留策略与定期清理,避免磁盘被长会话拖垮。
  • 语义检索依赖向量同步与嵌入质量,向量库启用后需要关注写入放大、索引膨胀与检索延迟,避免把“记忆”变成新的性能瓶颈。
  • 它是面向 Claude Code 的插件体系,工作流与其他编辑器/客户端的兼容性取决于你是否愿意维护适配与路由层。

常见问题

claude-mem 与 Claude Code 自带的 MEMORY.md 机制有什么核心差异?▾
claude-mem 把记忆外置为“可查询数据库+分层检索”,核心是自动捕获工具事件、AI压缩、索引检索与按需注入;而 MEMORY.md 更像一套文件化约定,启动时加载固定范围内容并靠人工组织主题文件。两者的取舍在于自动化与可检索性:claude-mem 用SQLite/FTS与可选向量库把“找得到”做成系统能力,并用渐进式披露控制token预算;MEMORY.md 则强调手动维护的可读性与简洁入口。若你需要跨多次会话的可回放与故障复现,数据库化记忆会更像基础设施。
为什么要用 SQLite + FTS5,而不是直接把摘要写进一个长文档?▾
长文档的问题不是“不能存”,而是“不可检索、不可分层、不可观测”。SQLite 让你把会话、观察、摘要拆成可索引的结构化记录,FTS5 让关键词定位变成毫秒级查询,而不是全文滚动与手工查找。更重要的是它为混合检索和渐进式披露提供了可计算的边界:你可以按时间、会话、工具类型筛选,再决定注入多少上下文。这样记忆就能在规模增长时仍保持可控,而不是越写越重、越重越难用。
Chroma 向量库一定要启用吗?什么时候建议开?▾
不一定。启用 Chroma 的价值在于语义召回:当你只记得意图或模糊线索、但关键词不确定时,向量检索能把相关摘要拉出来。建议在两类场景开启:你经常跨表述回忆同一问题,或你希望把“问题模式”做成可复用的记忆片段库。若你主要依赖错误码、文件名、命令等显式线索,FTS5 往往已足够,而且成本更可预测。
在 GitHub 上查看

项目指标

Star 数29.7 k
编程语言TypeScript
开源协议GNU Affero General Public License v3.0
部署难度简单

Table of Contents

  1. 01项目简介
  2. 02痛点 vs 创新
  3. 03架构深度解析
  4. 04部署指南
  5. 05落地场景
  6. 06避坑指南
  7. 07常见问题

相关项目

Trellis
Trellis
2.9 k·TypeScript
nanobot
nanobot
22.5 k·Python
Awesome LLM Apps
Awesome LLM Apps
96.4 k·Python
DeerFlow — 字节跳动开源超级智能体框架
DeerFlow — 字节跳动开源超级智能体框架
26.1 k·Python