Phase 83 — 层次化记忆系统2.0设计

版本: v4.1.0 创建日期: 2026-03-10 状态: ✅ 已实现 (v4.1.0)

---

一、模块概述

Phase 83 实现四层层次化记忆系统2.0，模拟人类记忆架构：工作记忆 → 短期记忆 → 长期记忆 → 核心记忆，支持遗忘曲线、记忆巩固、跨Agent共享、情景/语义检索。

1.1 核心目标

1. 四层记忆: Working → Short-term → Long-term → Core 分层存储和自动流转
2. 遗忘曲线: 基于Ebbinghaus遗忘曲线的记忆衰减和强化
3. 记忆巩固: 周期性从短期记忆提取模式，巩固到长期记忆
4. 跨Agent共享: Agent间选择性记忆共享，权限控制
5. 双重检索: 情景记忆(时间+场景)和语义记忆(概念+关系)并行检索

1.2 技术架构

┌──────────────────────────────────────────────────┐
│          Hierarchical Memory System 2.0          │
│                                                  │
│  ┌──────────┐ ┌──────────┐ ┌────────┐ ┌──────┐ │
│  │ Working  │→│Short-term│→│Long-term│→│ Core │ │
│  │ 7±2 items│ │ 遗忘曲线 │ │ 巩固   │ │ 永久 │ │
│  └──────────┘ └──────────┘ └────────┘ └──────┘ │
│  ┌───────────────────┐  ┌──────────────────────┐ │
│  │ ConsolidationMgr  │  │ CrossAgentSharing    │ │
│  │ 模式提取+巩固     │  │ 选择性共享+权限      │ │
│  └───────────────────┘  └──────────────────────┘ │
│  ┌───────────────────┐  ┌──────────────────────┐ │
│  │ EpisodicSearch    │  │ SemanticSearch       │ │
│  │ 时间+场景检索     │  │ 概念+关系检索        │ │
│  └───────────────────┘  └──────────────────────┘ │
│  ┌──────────────────────────────────────────────┐ │
│  │       Memory V2 IPC Layer (8 handlers)       │ │
│  └──────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────┘

---

二、核心模块设计

2.1 HierarchicalMemory (ai-engine/memory/hierarchical-memory.js)

四层层次化记忆系统主模块。

常量:

• MEMORY_LAYER: WORKING, SHORT_TERM, LONG_TERM, CORE
• MEMORY_TYPE: EPISODIC, SEMANTIC, PROCEDURAL
• CONSOLIDATION_STATUS: PENDING, PROCESSING, COMPLETED, FAILED

核心方法:

• initialize(deps) — 初始化记忆系统，启动巩固定时器
• store({ content, type, layer, metadata, agentId }) — 存储记忆到指定层
• recall({ query, layer, type, limit }) — 从指定层检索记忆
• consolidate() — 执行记忆巩固（短期 → 长期模式提取）
• share({ memoryId, targetAgentId, permissions }) — 跨Agent共享记忆
• getStats() — 获取各层记忆统计（数量、容量、遗忘率）
• prune({ layer, maxAge, threshold }) — 按遗忘曲线修剪过期记忆
• searchEpisodic({ timeRange, context, scene }) — 情景记忆检索
• searchSemantic({ concepts, relations, similarity }) — 语义记忆检索
• _applyForgettingCurve(memory) — 计算记忆强度衰减
• _promoteMemory(memoryId) — 记忆层级提升（高频访问自动升级）
• _demoteMemory(memoryId) — 记忆层级降级（低频访问自动降级）
• destroy() — 销毁系统，清理定时器

2.2 MemoryV2IPC (ai-engine/memory/memory-v2-ipc.js)

IPC通道注册和参数校验。

---

三、数据库设计

-- Phase 83: Hierarchical Memory 2.0
CREATE TABLE IF NOT EXISTS hierarchical_memories (
  id TEXT PRIMARY KEY,
  agent_id TEXT,
  layer TEXT DEFAULT 'working',      -- working, short_term, long_term, core
  memory_type TEXT DEFAULT 'episodic', -- episodic, semantic, procedural
  content TEXT NOT NULL,
  embedding TEXT,                     -- vector embedding for semantic search
  strength REAL DEFAULT 1.0,          -- memory strength (forgetting curve)
  access_count INTEGER DEFAULT 0,
  last_accessed INTEGER,
  consolidation_status TEXT DEFAULT 'pending',
  metadata TEXT,                      -- JSON: context, scene, tags
  created_at INTEGER,
  updated_at INTEGER,
  expires_at INTEGER
);

CREATE TABLE IF NOT EXISTS memory_sharing (
  id TEXT PRIMARY KEY,
  memory_id TEXT NOT NULL,
  source_agent_id TEXT NOT NULL,
  target_agent_id TEXT NOT NULL,
  permissions TEXT DEFAULT 'read',    -- read, write, reshare
  active INTEGER DEFAULT 1,
  created_at INTEGER,
  FOREIGN KEY (memory_id) REFERENCES hierarchical_memories(id)
);

CREATE TABLE IF NOT EXISTS memory_consolidation_log (
  id TEXT PRIMARY KEY,
  source_layer TEXT,
  target_layer TEXT,
  memories_processed INTEGER DEFAULT 0,
  patterns_extracted INTEGER DEFAULT 0,
  status TEXT DEFAULT 'pending',
  created_at INTEGER,
  completed_at INTEGER
);

---

四、IPC接口设计

Phase 83 — MemoryV2IPC (8 handlers)

通道	说明
memory:store	存储记忆
memory:recall	检索记忆
memory:consolidate	执行记忆巩固
memory:share	跨Agent共享
memory:get-stats	获取记忆统计
memory:prune	修剪过期记忆
memory:search-episodic	情景记忆检索
memory:search-semantic	语义记忆检索

---

五、前端集成

Pinia Stores

• hierarchicalMemory.ts — 记忆层级状态、检索结果、巩固进度、共享管理

Vue Pages

• HierarchicalMemoryPage.vue — 四层记忆可视化/检索/巩固控制/共享管理

Routes

• /hierarchical-memory — 层次化记忆系统

---

六、配置选项

hierarchicalMemory: {
  enabled: false,
  workingMemoryCapacity: 9,        // 7±2 items
  shortTermRetentionMs: 3600000,   // 1 hour
  consolidationIntervalMs: 900000, // 15 minutes
  forgettingCurveBase: 0.8,
  crossAgentSharingEnabled: true,
  maxLongTermMemories: 100000,
},

---

七、测试覆盖

测试文件: src/main/ai-engine/memory/__tests__/hierarchical-memory.test.js测试数量: 21 tests

分类	数量	说明
初始化	2	系统初始化、定时器启动
存储与检索	4	各层存储、按类型检索、容量限制、过期处理
遗忘曲线	3	强度衰减计算、高频访问强化、低频自动降级
记忆巩固	3	模式提取、层级提升、巩固日志
跨Agent共享	3	共享创建、权限校验、共享撤销
情景检索	3	时间范围、场景匹配、混合条件
语义检索	3	概念匹配、关系查询、相似度排序

---

八、Context Engineering

• step 5.3: setHierarchicalMemoryContext() — 注入层次化记忆上下文