From 5357a628f49a03fcca1f38d849c24efd9302a755 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Eason=20=28=E9=99=88=E5=8C=BB=E7=94=9F=29?= Date: Thu, 26 Feb 2026 23:39:44 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=9E=B6=E6=9E=84?= =?UTF-8?q?=E6=96=87=E6=A1=A3=20-=20=E5=8D=95=E5=BA=93=E8=9E=8D=E5=90=88?= =?UTF-8?q?=E8=AE=B0=E5=BF=86=E7=B3=BB=E7=BB=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 修正 Embedding 模型：text-embedding-v3 → text-embedding-v4 (Gemini Pro) - 修正 Collection 架构：多 Collection 物理隔离 → 单库融合 + metadata 软隔离 - 添加隔离机制代码示例 - 更新单一实体架构图（添加 agent_id 标注） --- docs/SYSTEM_ARCHITECTURE.md | 88 +++++++++++++++++++++++++++---------- 1 file changed, 65 insertions(+), 23 deletions(-) diff --git a/docs/SYSTEM_ARCHITECTURE.md b/docs/SYSTEM_ARCHITECTURE.md index 5e88cc5..a30b56c 100644 --- a/docs/SYSTEM_ARCHITECTURE.md +++ b/docs/SYSTEM_ARCHITECTURE.md @@ -139,33 +139,62 @@ ## 🔧 共享基础设施 -### 1. 记忆系统 (Memory System) +### 1. 记忆系统 (Memory System) - 单库融合架构 ``` -┌──────────────────────────────────────────────────────┐ -│ 记忆系统架构 │ -├──────────────────────────────────────────────────────┤ -│ ┌─────────────┐ ┌─────────────┐ │ -│ │ Mem0 Core │────▶│ Qdrant │ │ -│ │ (Python) │ │ (Vector DB)│ │ -│ └──────┬──────┘ └──────┬──────┘ │ -│ │ │ │ -│ │ Embedding │ 1024 维度 │ -│ │ (DashScope) │ localhost:6333 │ -│ ▼ ▼ │ -│ ┌─────────────────────────────────────┐ │ -│ │ MEMORY.md + memory/*.md │ │ -│ │ (文本记忆 · Git 版本控制) │ │ -│ └─────────────────────────────────────┘ │ -└──────────────────────────────────────────────────────┘ +┌──────────────────────────────────────────────────────────────┐ +│ 记忆系统架构 (单库融合) │ +├──────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────┐ ┌─────────────────────────┐ │ +│ │ Mem0 Core │────▶│ Qdrant │ │ +│ │ (Python) │ │ mem0_global_v4 │ │ +│ └──────┬──────┘ │ (唯一全局 Collection) │ │ +│ │ │ │ │ +│ │ Embedding │ ┌──────────────────┐ │ │ +│ │ v4 (1024) │ │ Payload Metadata │ │ │ +│ ▼ │ │ ┌──────────────┐ │ │ │ +│ ┌─────────────┐ │ │ │ agent_id │ │ │ │ +│ │ DashScope │ │ │ │ - "main" │ │ │ │ +│ │ Gemini Pro │ │ │ │ - "life" │ │ │ │ +│ │ text-embed- │ │ │ │ user_id │ │ │ │ +│ │ ding-v4 │ │ │ │ - "wang_..." │ │ │ │ +│ └─────────────┘ │ │ └──────────────┘ │ │ │ +│ │ └──────────────────┘ │ │ +│ └─────────────────────────┘ │ +└──────────────────────────────────────────────────────────────┘ ``` -**配置:** +**核心架构:** - **Qdrant:** `localhost:6333` -- **Embedding:** DashScope `text-embedding-v3` (1024 维度) -- **Collection:** `mem0_v4_main`, `mem0_v4_life` (隔离) +- **Embedding:** Gemini Pro `text-embedding-v4` (1024 维度) +- **Collection:** `mem0_global_v4` (**唯一全局 Collection**) +- **隔离方式:** 元数据标签软隔离 (`metadata.agent_id`) - **更新频率:** 每 5 分钟自动同步 +**隔离机制:** +```python +# 写入时注入 agent_id +metadata = { + "agent_id": "main", # 或 "life" + "user_id": "wang_yuanzhang", + "source": "openclaw" +} + +# 检索时使用 metadata 过滤 +memories = memory.search( + query, + user_id="wang_yuanzhang", + filters={"agent_id": "main"} # 软隔离关键 +) +``` + +**架构优势:** +- ✅ **维度统一** - 避免多 Collection 维度不一致导致的崩溃风险 +- ✅ **运维简化** - 单一 Collection，降低管理复杂度 +- ✅ **记忆共享** - 支持跨 Agent 记忆查询（可选） +- ✅ **最佳实践** - 符合 Mem0 官方推荐的元数据隔离模式 + --- ### 2. 系统服务 (Systemd Services) @@ -231,9 +260,21 @@ ▼ ▼ ▼ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ Session │ │ Session │ │ Session │ - │ (main) │ │ (life) │ │ (new) │ - │ Eason │ │ 张大师 │ │ 未来 │ - └──────────┘ └──────────┘ └──────────┘ + │ (main) │ │ (life) │ │ Session │ + │ Eason │ │ 张大师 │ │ (new) │ + │agent_id= │ │agent_id= │ │ 未来 │ + │ "main" │ │ "life" │ │ │ + └────┬─────┘ └────┬─────┘ └──────────┘ + │ │ + └──────┬───────┘ + │ + ▼ + ┌──────────────────────┐ + │ mem0_global_v4 │ + │ (唯一 Collection) │ + │ metadata.agent_id │ + │ 软隔离 │ + └──────────────────────┘ ``` **关键特性:** @@ -242,6 +283,7 @@ 3. **共享技能** - skills/ 目录下的技能所有 Agent 可用 4. **独立配置** - 每个 Agent 有自己的 workspace 和配置 5. **统一管理** - Eason 负责所有 Agent 的部署和优化 +6. **单库融合** - 所有记忆写入唯一 Collection，通过 `metadata.agent_id` 隔离 ---