5分钟装好cavemem：AI编程助手持久记忆快速上手教程

【免费下载链接】cavememFrozen — cross-agent persistent memory for coding assistants. Still works; the compressed-memory core now ships inside JuliusBrussee/caveman.项目地址https://gitcode.com/gh_mirrors/ca/cavemem点击查看免费下载cavemem 是一款专为 AI 编程助手打造的跨 IDE 持久记忆工具。它让 Claude Code、Codex、Cursor 等编码助手在会话结束后仍能记住上下文配合本快速上手教程5 分钟即可完成 cavemem 安装与配置。全程本地运行、无需云端是新手友好的 AI 编程记忆解决方案。一、cavemem 是什么给 AI 编程助手装上持久记忆 AI 编程助手有个通病会话一结束记忆就清零。cavemem 解决的正是这个问题——why agent forget when agent can remember。它的工作原理非常直接session event → redact private → compress → SQLite FTS5 ↑ MCP queries on demand核心亮点一览跨会话持久记忆Hooks 在会话边界自动捕获发生了什么本地 SQLite 负责长期保存压缩存储确定性的 caveman grammar 将散文压缩约75% token代码、路径、版本号逐字节保留混合检索SQLite FTS5 关键词 本地向量索引配合可调权重排序本地优先默认零网络调用、零云端依赖隐私可控Web 查看器http://localhost:37777提供只读界面用人类可读的方式浏览记忆压缩效果直观示例来自 README.mdInput: The auth middleware throws a 401 when the session token expires; we should add a refresh path. Stored: auth mw throws 401 session token expires. add refresh path. Viewed: The auth middleware throws a 401 when session token expires. Add refresh path.⚠️ 状态提示cavemem 目前处于frozen冻结维护状态一切功能仍可正常安装运行但不再新增特性其压缩记忆核心已并入后继项目 caveman。想深入了解压缩规格可看 docs/compression.md整体架构见 docs/architecture.md。二、一键安装步骤最快 5 分钟完成配置 步骤 1准备环境只需满足两个前置条件Node.js≥ 20包管理器 npm或 pnpm步骤 2全局安装 CLInpm install -g cavemem步骤 3为 IDE 注册 Hooks 与 MCPcavemem install # 默认接入 Claude Code cavemem install --ide cursor # 支持 cursor | gemini-cli | opencode | codex | copilot | augment | antigravity | bob一条命令即可无需手动编辑任何配置文件。各 IDE 能力对照IDE捕获记忆MCP 查询说明Claude Code✓✓完整 5 个生命周期 HooksOpenCode✓✓通过内置桥接插件Codex CLI / Copilot / Augment✓✓事件集略有缺失其余照常Cursor / Gemini CLI / Antigravity / Bob—✓query-only可检索其他 IDE 写入的记忆 用--ide参数为不同 IDE 分别安装Cursor 等没有 Hooks 机制的 IDE 走 query-only 模式详见 README.md 的能力矩阵。步骤 4验证安装状态cavemem status它会一次性展示IDE 接线情况、数据库记录数、embedding 回填进度、worker 进程状态。query-only 的 IDE 会被明确标注(query-only)避免数据库永远是空的的困惑。步骤 5打开记忆查看器cavemem viewer浏览器自动打开http://127.0.0.1:37777以人类可读形式浏览所有会话记忆。首次打开无需任何配置——worker 会自动生成本地 token 注入页面。三、核心功能体验让 AI 检索自己的记忆 终端直接搜索cavemem search auth middleware --limit 10混合排序BM25 向量余弦重排默认返回 10 条。AI 助手通过 MCP 查询cavemem 以渐进式披露设计暴露 MCP 工具先拿紧凑索引再按需取全文比一次性拉取全文省约10 倍 token。MCP 工具返回内容search(query, limit?)[{id, score, snippet, session_id, ts}]紧凑结果timeline(session_id, ...)会话内的时间线索引不含正文get_observations(ids[], expand?)按 ID 获取完整记忆正文list_sessions(limit?)最近会话列表enrich(query, note?)可选联网增强默认关闭推荐工作流search拿索引 → 审阅 ID →get_observations取正文。完整契约见 docs/mcp.mdMCP 服务源码位于 apps/mcp-server/src/server.ts。四、常用命令与配置速查 ⚙️高频命令清单命令作用cavemem status接线 数据 worker 状态总览cavemem doctor安装健康检查settings、db、端口、IDE 列表cavemem config show查看配置schema 自带文档cavemem search query终端搜索记忆cavemem export out.jsonl导出全部记忆为 JSONLcavemem import file.jsonl导入导出文件可重复执行安全合并cavemem reindex重建 FTS5 向量索引cavemem uninstall [--ide]移除 Hooks MCP关键配置项配置文件位于~/.cavemem/settings.json可用CAVEMEM_HOME环境变量重定向完整示例见 examples/settings.example.json配置键默认值说明dataDir解析后的 cavemem homeSQLite 数据库、模型、日志所在目录compression.intensityfull压缩强度lite/full/ultraembedding.providerlocal本地 / ollama / openai 三种向量方案workerPort37777本地查看器端口privacy.excludePatterns[]永不捕获的路径 glob如[**/.env, **/secrets/**]privacy.redactSecretstrue自动将 API Key 等替换为[REDACTED]enrich.enabledfalse可选联网增强关闭时绝不出网配置修改示例cavemem config set compression.intensity ultra 隐私设计private.../private内容在写入前被剥离worker 只绑定127.0.0.1/api/*需要本地 bearer token。五、进阶技巧与 FAQ Q如何把记忆迁移到另一台机器cavemem export backup.jsonl # 机器 A 导出 # 拷贝文件到机器 B cavemem stop cavemem import backup.jsonl cavemem start已存在的记录自动跳过重复导入无副作用详见 apps/cli/CHANGELOG.md。QWindows 上 Claude Code 捕获不到记忆Claude Code 在 Windows 上也通过sh -c执行 Hooks。若Git\bin不在用户Path中sh无法解析捕获会静默失败。将C:\Program Files\Git\bin加入Path后用where.exe sh验证cavemem doctor和cavemem install都会主动检查并给出警告。Q数据存在哪里会上云吗全部在本地~/.cavemem或CAVEMEM_HOME指定目录无网络调用仅当手动开启enrich.enabled并显式调用时才会产生外部请求。Q想彻底卸载cavemem uninstall --ide claude-codeQhooks 脚本长什么样每个生命周期事件对应一个极简 stub位于 hooks-scripts/ 目录例如 hooks-scripts/session-start.sh 只做一件事exec cavemem hook run session-start。总结cavemem 是 AI 编程助手持久记忆的小而美方案npm 一条命令安装、cavemem install一键接线、cavemem status即查状态——5 分钟即可让 Claude Code 等助手跨会话记住你的项目上下文。本地 SQLite FTS5 向量混合检索压缩存储省 75% token完全离线运行。现在就去试试让你的 AI 编程助手从此过目不忘吧 赞分享【免费下载链接】cavememFrozen — cross-agent persistent memory for coding assistants. Still works; the compressed-memory core now ships inside JuliusBrussee/caveman.项目地址https://gitcode.com/gh_mirrors/ca/cavemem点击查看免费下载相关推荐如何5分钟给AI编程代理装上持久记忆MegaMemory安装与快速开始教程如何5分钟给AI编程代理装上持久记忆MegaMemory安装与快速开始教程 MegaMemory 是一个开源的 MCP 服务器能给 AI 编程代理如 op5分钟快速上手Claude CodeAI编程助手的完整安装教程5分钟快速上手Claude CodeAI编程助手的完整安装教程 Claude Code是一款基于终端的AI编程助手工具能够理解您的代码库并通过自然语言命令帮人工智能AI Agent代码智能体开发工具CLIAI 技能/插件5分钟上手OKF Agent Memory从零搭建AI智能体持久记忆系统的快速教程5分钟上手OKF Agent Memory从零搭建AI智能体持久记忆系统的快速教程 OKF Agent Memory 是一款专为 AI 编码智能体设计的 GiAgent 记忆人工智能AI 应用MCP 服务CLI知识管理上一篇提升React Native应用用户体验react-native-hyperlink高级用法与最佳实践下一篇go-clean-arch API限流基于令牌桶算法的实现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考