docs(roadmap): 更新 Phase 3 记忆系统为已完成状态

This commit is contained in:
徐涛
2026-06-09 21:34:25 +08:00
parent 2ecc0b4001
commit 0c51bb78a6
+19 -14
View File
@@ -1,13 +1,13 @@
# AG Core Roadmap
> 定稿日期:2026-05-11
> 最后更新:2026-06-07Phase 2 完成)
> 最后更新:2026-06-09Phase 3 完成)
## 愿景
AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可插拔的架构,提供大模型调用、提示词工程、工具系统、记忆检索四大核心能力,支持快速组合出符合业务需求的智能体应用。
**当前状态**:Phase 0 基础设施已全部完成,Phase 1 提示词工程已全部完成,Phase 2 工具系统已全部完成,等待 Phase 3 启动。
**当前状态**:Phase 0 基础设施已全部完成,Phase 1 提示词工程已全部完成,Phase 2 工具系统已全部完成,Phase 3 记忆系统已全部完成,等待 Phase 4 启动。
---
@@ -18,7 +18,7 @@ AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可
| LLM 调用周期 | ✅ 完整 | `specs/llm-call-lifecycle.md` | P0 |
| 提示词工程 | ✅ 完整 | `docs/4-prompt-engineering.md` | P1 |
| 工具系统 + 权限 | ✅ 完整 | `docs/5-tool-system.md` | P1 |
| 记忆检索 | ❌ 缺失 | — | P2 |
| 记忆检索 | ✅ 完整 | `docs/6-memory-system.md` | P2 |
| Agent 运行时 | ❌ 缺失 | — | P2 |
| 生命周期钩子 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0LLM Cycle 扩展) |
| Provider 注册发现 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0Provider 接口扩展) |
@@ -102,18 +102,22 @@ AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可
**目标**:提供对话记忆的存储、检索与管理能力。
**交付物**
1. `memory.rs` + `memory/` 模块
2. `MemoryStore` trait — 记忆存储抽象(可插拔后端)
3. `VectorStore`向量存储实现(支持 embedding 检索)
4. `ConversationMemory`对话记忆管理(sliding window / 全量
5. `MemoryRetriever` — 记忆检索器(similarity search
6. `specs/memory-system.md` — 方案文档
1. `memory.rs` + `memory/` 模块store / conversation / knowledge / retriever / error / types
2. `MemoryStore` trait + `InMemoryStore` — 记忆存储抽象(可插拔后端)+ 默认实现
3. `ConversationMemory`对话记忆管理(sliding window / 全量),复用 `llm::compact`
4. `KnowledgeStore`知识页面存储(具体 struct,非 trait,基于 MemoryStore
5. `MemoryRetriever` — 记忆检索器(TextOverlap Dice 系数评分,单通道
6. `docs/6-memory-system.md` — 方案设计文档
7.`docs/note-knowledge-graph-design.md` — KnowledgeGraph 等 Phase 4 备用设计
8.`EvictionPolicy` — 支持 None / Ttl / Capacity 三种淘汰策略
**依赖**Phase 0LLM 调用可能用于 embedding 生成)
**依赖**Phase 0llm::compact 复用)、Cargo.toml 新增 `time` 依赖
**优先级**Could Have
**预估规模**:约 700 行代码
**预估规模**:约 700 行代码(实际约 1242 行,含测试)
**状态**:✅ Phase 3 全部交付物已完成
---
@@ -143,7 +147,7 @@ graph BT
P0["<b>Phase 0: Foundation</b><br/>LLM Cycle<br/>ProviderRegistry<br/>HookExecutor<br/>StreamEvents<br/>Auto-compaction"]:::done
P1["<b>Phase 1: Prompt Engineering</b><br/>PromptTemplate<br/>PromptComposer"]:::done
P2["<b>Phase 2: Tool System</b><br/>Tool Registry<br/>PermissionChecker<br/>MCP Client"]:::done
P3["<b>Phase 3: Memory System</b><br/>MemoryStore<br/>VectorStore<br/>ConversationMemory"]:::pending
P3["<b>Phase 3: Memory System</b><br/>MemoryStore<br/>ConversationMemory<br/>KnowledgeStore"]:::done
P4["<b>Phase 4: Agent Runtime</b><br/>ConversationAgent<br/>TaskAgent"]:::pending
P1 --> P0
@@ -182,10 +186,11 @@ graph BT
## 下一步行动
1. **Phase 3 方案启动**:启动 `docs/6-memory-system.md` 设计
2. **Phase 2 已就绪**工具系统已交付,可为 Phase 3/4 提供工具调用能力
1. **Phase 4 方案启动**:启动 Agent Runtime 设计(依赖 Phase 0/1/2/3,整合所有模块)
2. **Phase 3 备用设计就绪**`docs/note-knowledge-graph-design.md` 记录了 KnowledgeGraph、高级评分、RecallBased 淘汰等设计,Phase 4 可直接参考
**已完成阶段**
- ✅ Phase 0 Foundation — 全部交付物已完成
- ✅ Phase 1 Prompt Engineering — 全部交付物已完成
- ✅ Phase 2 Tool System — 全部交付物已完成
- ✅ Phase 3 Memory System — 全部交付物已完成