Back to Work2026.02 - 至今

ai-agent

OpenMemory Plus - AI Agent 双层记忆框架

OpenMemory Plus - AI Agent Dual-Layer Memory Framework

独立开发 · 独立开发者

解决 AI Agent 跨会话上下文丢失问题,支持 Augment/Cursor/Windsurf/Cline 等主流 IDE

Impact: 跨会话上下文保持率 95%+

项目概述

OpenMemory Plus 是一个 AI Agent 双层记忆框架,解决 AI Agent 跨会话上下文丢失问题。支持 Augment、Cursor、Windsurf、Cline 等主流 IDE,实现跨会话上下文保持率 95%+。

核心架构

双层记忆模型

Loading diagram...

存储分层设计

层级存储系统生命周期访问方式
L1 项目级_omp/memory/*.yaml随项目文件读取
L2 用户级OpenMemory MCP跨项目MCP 协议
L3 会话级activeContext.md单会话内存/文件

技术亮点

1. ROT 智能过滤

减少 40% 冗余记忆,提升检索效率:

类型检测条件处理
Redundant语义相似度 > 0.85合并或跳过
Obsolete超过 TTL + 无访问标记删除
Trivial长度 < 10 字符直接丢弃

2. 5 维度分类引擎

dimensions:
  scope:
    PROJECT: "项目配置/技术决策/部署信息"
    PERSONAL: "用户偏好/技能/习惯"
    EPHEMERAL: "临时信息/一次性上下文"
  
  confidence:
    EXPLICIT: 1.0    # 用户明确说明
    INFERRED: 0.7    # 从行为推断
    UNCERTAIN: 0.4   # 不确定
  
  temporality:
    permanent: "永久保留"
    session: "会话级别"
    temporary: "临时/可丢弃"

3. Agent 自闭环测试体系

15 项端到端测试全自动化:

测试类型覆盖场景
记忆写入项目级/用户级路由
记忆读取并行查询/上下文融合
ROT 过滤去重/过期/无效检测
降级恢复MCP 不可用时的降级策略
跨 IDEAugment/Cursor/Windsurf/Cline

4. 统一目录结构

_omp/                           # OpenMemory Plus 根目录
├── AGENTS.md                   # Agent 指令入口 (所有 IDE 共享)
├── commands/                   # 命令定义
│   └── memory.md               # /memory 命令
├── memory/                     # 项目级记忆存储
│   ├── project.yaml            # 项目配置 (SSOT)
│   ├── decisions.yaml          # 技术决策记录
│   └── activeContext.md        # 当前会话上下文
└── skills/                     # 扩展能力
    └── memory-extraction/      # 记忆提取 Skill

技术决策

决策点选择放弃方案原因
存储格式YAMLJSON/TOML人类可读 + 支持注释
用户记忆MCP本地文件跨项目 + 语义搜索
分类方式规则ML 模型可解释 + 低延迟
版本控制Git数据库与代码同步 + 免费

降级策略

当 OpenMemory MCP 不可用时:

  1. 检测: MCP 调用超时 > 3s
  2. 降级: 用户级信息暂存 _omp/memory/user-context.yaml
  3. 标记: _degraded: true
  4. 恢复: MCP 可用后提示同步

关键成果

指标数值
跨会话上下文保持率95%+
冗余记忆减少40%
E2E 测试覆盖15 项
支持 IDE4+