From 8bc3062a8a9211459d01215aab5dab8189da6f0a Mon Sep 17 00:00:00 2001
From: li_zhonghua <lizhonghua3@huawei.com>
Date: Mon, 3 Aug 2026 17:44:52 +0800
Subject: [PATCH 1/2] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E8=AE=B0=E5=BF=86mem2.0?=
 =?UTF-8?q?=20roadmap?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/Roadmap.md | 159 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 159 insertions(+)
 create mode 100644 docs/Roadmap.md

diff --git a/docs/Roadmap.md b/docs/Roadmap.md
new file mode 100644
index 00000000..bb4631c1
--- /dev/null
+++ b/docs/Roadmap.md
@@ -0,0 +1,159 @@
+# agent-memory Roadmap
+
+> Agent-memory在1.0版本上进行了全量的架构升级，版本规划从 **V0.2.0** 起编号。下面按照版本记录每个版本交付的主要新特性；后续版本为规划草案，随立项与 Issue 调整，不构成实现承诺。
+>
+> 最近一次修订日期：2026-08-03
+
+---
+
+## 版本总览
+
+
+| 版本         | 定位           | 状态         |
+| ---------- | ------------ | ---------- |
+| **V0.2.0** | 结构化记忆内核可用闭环  | 📋 规划中（基线） |
+| **V0.2.1** | 管理增强+分层构建及演进 | 📋 规划中     |
+| **V0.2.2** | 群体记忆构建+多模态   | 📋 规划中     |
+
+
+---
+
+## V0.2.0（规划中）
+
+本版本构建基础记忆能力，包含从数据接入、记忆构建、记忆检索、记忆管理能力，并对外提供记忆API。其主要包括以下特性
+
+### 1. 统一记忆接口（Memory API）
+
+- 形态无关 Core API：`write` / `recall` / `get` / `update` / `delete` / `evolve`
+
+### 2. 编排与生命周期（Control）
+
+- 支持按照配置或metadata进行pipeline创建
+- 支持基于Space的多租户记忆隔离
+
+### 3. 接入层（Ingest）
+
+- `TextSource` + `SimpleIngestor`：文本 → `MemoryUnit`（不落盘）
+- `PassthroughNormalizer` 文本通路
+
+### 4. 记忆构建与演进（Construction）
+
+- 支持多形式索引构建：全文 / 向量 / 混合（含 L0/L1 层级索引）
+- 支持抽取多种记忆内容（情景、语义、程序、core），支持自定义抽取模式。
+- 支持构建记忆缓存，实现快速记忆检索
+- 支持基于特定条件触发对缓存记忆的抽取及长期记忆构建
+
+### 5. 记忆检索（Retrieval）
+
+- 支持对查询进行解析及向量化
+- 支持扁平及树状Filter过滤
+- 支持基于关键词、向量、图的召回
+- 支持基于RRF、加权RRF、最大值及分层等多种融合方式
+
+### 6. 记忆存储（Storage）
+
+- 支持六类记忆存储：KV / Vector / Fulltext / Graph / Fusion / FS
+- 支持对接的生产后端：SQLite KV、Redis KV、Milvus、Elasticsearch、nano_graphrag、Milvus Graph Fusion、本地 FS
+
+### 7. 多形态接入面（Bootstrap）
+
+- 支持以SDK形式进行进程内嵌入使用
+- 支持CLI形式调用
+
+### 8. Agent 插件
+
+- JiwenSwarm `MemoryProvider` 适配（进程内 / HTTP）
+- 支持对接OpenClaw
+
+### 9 评测框架
+
+- 支持LoCoMo / LongMemEval 进行评测
+
+---
+
+## V0.2.1 （规划中）
+
+本版本计划构建或增强以下特性：
+
+### **记忆存储**
+
+- 对接GaussDB
+
+### **记忆构建**
+
+- 支持时序分层记忆构建
+- 支持记忆冲突处理算法优化
+- 支持多策略融合的记忆遗忘
+- 支持agent记忆经验沉淀和skill生成
+- 支持基于图拓展的闲时巩固
+- 支持wiki文档记忆构建
+
+### **记忆检索**
+
+- 支持分层召回
+- 支持基于wiki文档记忆的检索
+
+### **记忆管理**
+
+- 支持用户鉴权及权限管理
+- 支持索引数据加密
+
+### **多模态接入面**
+
+- 支持基于Skill形式的记忆调用
+
+### **Agent插件**
+
+- 支持对接ClaudeCode及Codex、Hermes
+
+---
+
+## V0.2.2 （规划中）
+
+本版本计划构建或增强以下特性：
+
+### **记忆存储**
+
+- 支持多模态记忆压缩
+
+### **记忆构建**
+
+- 支持基于动态文件的记忆构建
+- 支持多模态对话记忆构建
+- 支持共享记忆增强构建
+
+### **记忆检索**
+
+- 支持渐进式披露召回
+
+### **记忆管理**
+
+- 支持用户鉴权及权限管理
+- 支持索引数据加密
+
+### **多模态接入面**
+
+- 支持基于Skill形式的记忆调用
+
+### **Agent插件**
+
+- 支持对接ClaudeCode及Codex、Hermes
+
+---
+
+## 规划原则
+
+1. **V0.2.0 为能力基线**：后续版本只增能力或硬化，不轻易破坏 Core API 语义；破坏性变更需升 minor 并写迁移说明。
+2. **features 归档纪律不变**：影响公开接口或跨模块取舍的特性，仍按「代码 → 测试 → docs/features」三连提交。
+3. **与 design 的关系**：`docs/design/` 为长期愿景；本 Roadmap 是可执行切片。design 中开放问题（architecture §17）在对应版本立项时再定案。
+
+---
+
+## 修订记录
+
+
+| 日期         | 说明                     |
+| ---------- | ---------------------- |
+| 2026-08-03 | 按照当日代码及与各团队对其的情况进行初稿规划 |
+
+

From 52d86bed8ca1596b681488ea9e0a598929f2c37d Mon Sep 17 00:00:00 2001
From: li_zhonghua <lizhonghua3@huawei.com>
Date: Sat, 8 Aug 2026 16:20:04 +0800
Subject: [PATCH 2/2] update roadmap.md

---
 docs/Roadmap.md | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/docs/Roadmap.md b/docs/Roadmap.md
index bb4631c1..f9f0e168 100644
--- a/docs/Roadmap.md
+++ b/docs/Roadmap.md
@@ -98,13 +98,10 @@
 - 支持用户鉴权及权限管理
 - 支持索引数据加密
 
-### **多模态接入面**
-
-- 支持基于Skill形式的记忆调用
 
 ### **Agent插件**
 
-- 支持对接ClaudeCode及Codex、Hermes
+- 支持对接ClaudeCode
 
 ---
 
@@ -121,6 +118,7 @@
 - 支持基于动态文件的记忆构建
 - 支持多模态对话记忆构建
 - 支持共享记忆增强构建
+- 支持群体记忆构建
 
 ### **记忆检索**
 
@@ -128,8 +126,7 @@
 
 ### **记忆管理**
 
-- 支持用户鉴权及权限管理
-- 支持索引数据加密
+- 支持记忆可追溯管理
 
 ### **多模态接入面**
 
@@ -137,7 +134,7 @@
 
 ### **Agent插件**
 
-- 支持对接ClaudeCode及Codex、Hermes
+- 支持对接Codex、Hermes
 
 ---