【agentmemory】让 AI 编程助手彻底告别“失忆”，实现跨会话的上下文无缝同步
这是一个专为 AI 编程智能体设计的持久化记忆引擎。它通过在后台静默捕获、结构化压缩开发过程中的上下文信息，彻底解决了不同会话间 AI 助手“失忆”、导致开发者不得不反复解释技术栈与配置偏好的痛点。
主要功能与特性
* 跨平台通用记忆库：基于标准 MCP、Hooks 与 REST API，无缝支持 Claude Code、Cursor、Gemini CLI、Codex CLI 等数十款主流编程助手。一个记忆服务端即可供所有智能体共享。
* 自动化上下文捕获：利用生命周期钩子自动记录工具调用、文件操作与测试结果，全程零手动干预，告别繁琐的 CLAUDE.md 或规则文件手动维护。
* 四层记忆进化机制：模拟人类认知模型，将数据划分为工作记忆、情景记忆、语义记忆与程序记忆。结合遗忘曲线自动强化高频知识，并清理过期或冲突内容。
* 混合高精度检索：采用 BM25 关键词匹配、向量语义搜索与知识图谱遍历相结合的融合算法（RRF），显著提升复杂逻辑与历史代码片段的召回率。
* 极致的上下文优化：智能过滤并注入最相关的 Top-K 记忆块，将单会话上下文 Token 消耗压缩至约 1,900 个（年成本约 $10），有效避免突破大模型窗口限制。
* 隐私保护与全链路审计：内置隐私过滤器自动剥离 API 密钥与敏感凭证，提供 Git 快照版本控制、引用溯源与操作审计日志，确保记忆数据安全可控。
* 实时可视化看板：内置本地 Web 界面（:3113 端口），支持时间轴回放、完整会话重演与记忆槽状态实时监控。
快速安装与使用
项目提供了极简的启动方式，你可以通过 npm 全局安装，或直接用 npx 免安装体验：
# 推荐方式：全局安装后随处可用
npm install -g @agentmemory/agentmemory
agentmemory # 启动本地记忆服务器（默认端口 3111）
agentmemory demo # 运行演示：自动注入示例项目并测试语义检索
# 或免安装运行
npx @agentmemory/agentmemory
服务启动后，执行 agentmemory connect <你的助手名称>（如 claude-code）即可一键完成插件注入与钩子挂载。随后打开浏览器访问 http://localhost:3113，即可实时查看记忆构建与检索过程。
适用场景与目标用户
该工具主要面向重度依赖 AI 辅助编程的开发者与技术团队。如果你日常需要频繁切换多个开发会话，厌倦了每次重新向 AI 描述项目架构、历史 Bug 修复路径或本地开发偏好；或者团队内部多人协作时，希望多个 AI 智能体能够共享上下文、避免重复决策与资源争抢，它都能提供开箱即用的底层支撑。尤其适用于长期迭代的中大型项目、微服务架构维护以及追求极致上下文管理的工程化场景。
总结
该项目以扎实的工程架构将人类记忆规律与底层检索技术深度融合，用极低的 Token 开销实现了 AI 编程助手从“单次交互工具”向“长期项目伙伴”的平滑演进。其无侵入的代理模式、多模型兼容性与对隐私安全的严谨考量，使其在当前 AI 开发工具链中具备很强的实用价值。对于希望构建流畅、无断点开发体验的工程师而言，将其纳入日常工作流是一个高效且低成本的升级选择。
