# 全局架构总览 本文档提供 Agent Memory System 的全局架构视角，用于理解系统整体设计、模块协作关系和核心数据流。 > **⚠️ 重要**：在阅读本文档前，请先阅读 [执行模型说明](architecture_execution_model.md)，了解系统的运行方式、触发场景和使用时机。 > 文档标题后面标注为 **（新）** 字样皆为最新方案。 --- ## 架构定位（新） Agent Memory System 采用**分层架构**，以认知模型层为核心，ContextOrchestrator为统一入口和总控中心。 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 顶层：总控层（统一入口） │ │ ┌───────────────────────────────────────────────────────────┐ │ │ │ ContextOrchestrator（总控中心） │ │ │ │ • Token预算管理 • 检索决策 • 多源协调 • 结果压缩 │ │ │ │ • 认知模型构建 • 全局调度 • 可观测性管理 │ │ │ └───────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 中间层：协调层 │ │ │ │ ┌───────────────────────────────────────────────────────────┐ │ │ │ 认知模型层（核心业务逻辑） │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │Cognitive│ │Causal │ │Knowledge│ │Retrieval│ │ │ │ │ │Model │ │Chain │ │Gap │ │Decision │ │ │ │ │ │Builder │ │Extractor│ │ID │ │Engine │ │ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │State │ │State │ │Cross │ │Memory │ │ │ │ │ │Consistency│Inference│Session │ │Forgetting│ │ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │ └───────────────────────────────────────────────────────────┘ │ │ │ │ ┌───────────────────────────────────────────────────────────┐ │ │ │ 双轨架构（认知模型的具体实现层） │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ │ │ 双轨并行处理器 │ │ │ │ │ │ ┌──────────┐ ┌──────────┐ │ │ │ │ │ │ │轨道A │ │轨道B │ │ │ │ │ │ │ │语义桶 │ │链提取 │ │ │ │ │ │ │ │提炼 │ │ │ │ │ │ │ │ │ └──────────┘ └──────────┘ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └──────────┬───────────┘ │ │ │ │ │ │ ▼ │ │ │ │ │ │ 融合层（关联+验证+摘要） │ │ │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ │ │ P2优化（异步并行+缓存+监控） │ │ │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ └───────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 基础层：存储层 │ │ ┌──────────────────┐ ┌──────────────────┐ │ │ │ 短期记忆存储 │ │ 长期记忆存储 │ │ │ │ ShortTermMemory │ │ LongTermMemory │ │ │ │ Manager │ │ Manager │ │ │ └──────────────────┘ └──────────────────┘ │ │ ┌──────────────────┐ ┌──────────────────┐ │ │ │ 记忆索引 │ │ Redis存储 │ │ │ │ MemoryIndexer │ │ RedisAdapter │ │ │ └──────────────────┘ └──────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 底层：基础设施层 │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ 类型定义 │ │ 配置管理 │ │ 工具类 │ │ │ │ type_defs │ │ config │ │ utils │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ 加密解密 │ │ 权限控制 │ │ 隐私保护 │ │ │ │ encryption │ │ permission │ │ privacy │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ ┌──────────────┐ ┌──────────────┐ │ │ │ 监控系统 │ │ 性能优化 │ │ │ │ Monitoring │ │ LRUCache │ │ │ └──────────────┘ └──────────────┘ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ### 认知模型数据流（新） ``` 原始信息输入 │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 认知模型构建器 │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 信息组织与结构化 │ │ │ │ │ │ │ │ 输入: 原始对话、工具结果、检索结果、状态快照 │ │ │ │ 输出: 结构化认知模型 │ │ │ │ │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │任务上下文│ │已知事实 │ │知识缺口 │ │待决策项 │ │ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │已完成路径│ │待验证假设│ │当前约束 │ │ 链集 │ │ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │ │ │ │ │ │ ┌─────────────────────────────────────────────┐ │ │ │ │ │ 链集（由双轨架构提取） │ │ │ │ │ │ │ │ │ │ │ │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ │ │ │ │ │ │因果链│ │逻辑链│ │操作链│ │叙事链│ ... │ │ │ │ │ │ └──────┘ └──────┘ └──────┘ └──────┘ │ │ │ │ │ │ ┌──────┐ │ │ │ │ │ │ │时间链│ │ │ │ │ │ │ └──────┘ │ │ │ │ │ │ │ │ │ │ │ │ • 因果链: 问题→原因→解决方案 │ │ │ │ │ │ • 逻辑链: 前提→推理→结论 │ │ │ │ │ │ • 操作链: 动作→步骤→结果 │ │ │ │ │ │ • 叙事链: 开端→发展→转折→结局 │ │ │ │ │ │ • 时间链: 过去→现在→未来 │ │ │ │ │ └─────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ to_context_string() → 模型可直接理解的上下文字符串 │ └─────────────────────────────┬───────────────────────────────┘ │ ┌───────────────┼───────────────┐ ▼ ▼ ▼ ┌───────────────┐ ┌───────────┐ ┌───────────────┐ │ 检索时机决策 │ │ 状态推理 │ │ 遗忘机制 │ │ 是否需要检索? │ │ 推断未知 │ │ 清理冷数据 │ └───────────────┘ └───────────┘ └───────────────┘ │ │ │ └───────────────┼───────────────┘ ▼ ┌───────────────┐ │ 模型决策 │ └───────────────┘ ``` --- ## 模块协作图 本节展示系统各模块间的协作关系，包含旧的模块协作图和新的四层架构状态协调信息。 ### 模块协作图（包含四层架构）（新） ``` 用户交互 │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 【顶层：总控层】 │ │ ┌───────────────────────────────────────────────────────┐ │ │ │ ContextOrchestrator（统一入口、总控中心） │ │ │ │ • Token预算管理 • 检索决策 • 多源协调 • 结果压缩 │ │ │ │ • 认知模型构建 • 全局调度 • 可观测性管理 │ │ │ │ 状态同步: sync_layer_state(orchestrator, state) │ │ │ └─────────────────────┬───────────────────────────────────┘ │ └─────────────────────────┼─────────────────────────────────────┘ │ │ 【下行传播】 ▼ ┌─────────────────────────────────────────────────────────────┐ │ 【中间层：协调层】 │ │ ┌───────────────────────────────────────────────────────┐ │ │ │ 认知模型层（核心业务逻辑） │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │Cognitive│ │Causal │ │Knowledge│ │Retrieval│ │ │ │ │ │Model │ │Chain │ │Gap │ │Decision │ │ │ │ │ │Builder │ │Extractor│ │ID │ │Engine │ │ │ │ │ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │ │ │ │ │ │ │ │ │ │ │ │ └───────────┴───────────┴───────────┘ │ │ │ │ 状态同步: sync_layer_state(cognitive_model, state) │ │ │ └───────────────────┼───────────────────────────────────┘ │ │ │ │ │ ┌────────────────────┼───────────────────────────────────┐ │ │ │ ▼ │ │ │ │ ┌───────────────────────────────────────────────────┐ │ │ │ │ │ 双轨架构（认知模型的具体实现层） │ │ │ │ │ │ ┌──────────┐ ┌──────────┐ │ │ │ │ │ │ │轨道A │ │轨道B │ │ │ │ │ │ │ │语义桶 │ │链提取 │ │ │ │ │ │ │ │提炼 │ │ │ │ │ │ │ │ │ └──────────┘ └──────────┘ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └──────────┬───────────┘ │ │ │ │ │ │ ▼ │ │ │ │ │ │ 融合层（关联+验证+摘要） │ │ │ │ │ │ 状态同步: sync_layer_state(dual_track, state) │ │ │ │ │ └───────────────────┬───────────────────────────────┘ │ │ │ └──────────────────────┼───────────────────────────────────┘ └─────────────────────────┼─────────────────────────────────────┘ │ │ 【下行传播】 ▼ ┌─────────────────────────────────────────────────────────────┐ │ 【基础层：存储层】 │ │ ┌──────────────────┐ ┌──────────────────┐ │ │ │ 短期记忆存储 │ │ 长期记忆存储 │ │ │ │ ShortTermMemory │ │ LongTermMemory │ │ │ │ Manager │ │ Manager │ │ │ │ 5种语义桶 │ │ 7种记忆分类 │ │ │ │ 链缓冲区 │ │ 记忆索引 │ │ │ └────────┬─────────┘ └────────┬─────────┘ │ │ │ │ │ │ └──────────┬──────────┘ │ │ │ │ │ 状态同步: sync_layer_state(storage, state) │ │ │ │ │ 【上行反馈】 │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 【底层：基础设施层】 │ │ ┌──────────────┐ ┌──────────────┐ │ │ │ 类型定义 │ │ 加密解密 │ │ │ │ 监控系统 │ │ 状态捕捉器 │ │ │ │ LayerStateSync│ │ encryption │ │ │ └──────────────┘ └──────────────┘ │ │ 状态上报: sync_layer_state(infrastructure, state) │ └─────────────────────────────────────────────────────────────┘ ┌─────────────────────────────────────────────────────────────┐ │ 【全局状态协调机制（LayerStateSync）】 │ │ 状态传播规则: │ │ • 总控层 → 认知模型层、双轨架构（下行） │ │ • 认知模型层 → 双轨架构、存储层（下行） │ │ • 存储层 → 认知模型层、总控层（上行反馈） │ │ • 基础设施层 → 存储层、总控层（监控上报） │ │ 状态一致性检查: │ │ • 认知模型层 vs 双轨架构（链集一致性） │ │ • 协调层 vs 存储层（记忆一致性） │ │ 状态事件类型: ORCHESTRATOR_STATE_CHANGE / ...（31种） │ └─────────────────────────────────────────────────────────────┘ ``` ### 核心模块职责（包含四层架构）（新） | 模块 | 层级 | 职责 | 输入 | 输出 | |------|------|------|------|------| | **总控层** | | | | | | ContextOrchestrator | 顶层 | 统一入口、Token预算、检索决策、多源协调、结果压缩 | 情境、预算 | 上下文包 | | TokenBudgetManager | 顶层 | Token预算管理 | 上下文大小 | Token预算 | | **协调层：认知模型层** | | | | | | CognitiveModelBuilder | 协调层 | 认知模型构建 | 上下文、记忆数据 | CognitiveModel | | CausalChainExtractor | 协调层 | 因果链提取 | 对话历史、事件流 | List[CausalChain] | | KnowledgeGapIdentifier | 协调层 | 知识缺口识别 | 认知模型、当前任务 | List[KnowledgeGap] | | RetrievalDecisionEngine | 协调层 | 检索决策 | 情境、Token预算 | RetrievalPlan | | **协调层：双轨架构** | | | | | | 语义桶提炼 | 协调层 | 语义分类、话题聚合 | 消息内容、语义类型 | 记忆项 | | 链提取 | 协调层 | 链提取（5种） | 对话历史 | List[Chain] | | 融合层 | 协调层 | 关联、验证、摘要 | 语义桶、链 | 融合结果 | | **存储层** | | | | | | ShortTermMemoryManager | 基础层 | 短期记忆管理 | 提炼条目 | 记忆项 | | LongTermMemoryManager | 基础层 | 长期记忆管理 | 提炼条目 | 记忆条目、推荐结果 | | MemoryIndexer | 基础层 | 记忆索引 | 记忆数据 | 索引结果 | | **基础设施层** | | | | | | LayerStateSync | 底层 | 四层架构状态协调 | 状态事件 | 状态快照 | | MonitoringSystem | 底层 | 监控系统 | 运行状态 | 性能指标 | | Encryption | 底层 | 加密解密 | 明文数据 | 加密数据 | | PrivacyManager | 底层 | 隐私保护 | 敏感数据 | 过滤结果 | --- ## 顶层：总控层 - ContextOrchestrator（新） ### 职责 ContextOrchestrator 是整个系统的**统一入口和总控中心**，负责： 1. **Token预算管理**：控制上下文大小，优化检索策略 2. **检索决策**：根据情境决定检索范围和优先级 3. **多源协调**：协调短期记忆、长期记忆、认知模型、双轨架构 4. **结果压缩**：将检索结果压缩为可用的上下文 5. **认知模型构建**：调用认知模型层构建完整的认知模型 6. **全局调度**：调度协调层各模块的执行顺序 7. **可观测性管理**：监控系统运行状态和性能指标 ### 核心接口 ```python class ContextOrchestrator: def __init__(self): self.token_budget = TokenBudgetManager() self.retrieval_engine = RetrievalDecisionEngine() self.cognitive_model_builder = CognitiveModelBuilder() self.dual_track_processor = OptimizedDualTrackProcessor() async def orchestrate(self, context: ContextRequest) -> ContextResponse: """统一入口：协调所有层级完成上下文重构""" # 1. Token预算评估 budget = self.token_budget.estimate(context) # 2. 检索决策 retrieval_plan = self.retrieval_engine.decide(context, budget) # 3. 调用认知模型层 cognitive_model = await self.cognitive_model_builder.build(context) # 4. 调用双轨架构（如需要） if retrieval_plan.use_dual_track: dual_track_result = await self.dual_track_processor.process(context, cognitive_model) # 5. 多源整合 integrated_result = await self._integrate_sources(retrieval_plan, dual_track_result) # 6. 结果压缩 compressed_context = self._compress_context(integrated_result, budget) return ContextResponse(compressed_context) ``` ### 与其他层的关系（新） ``` ContextOrchestrator (总控层) │ ├─→ 认知模型层（协调层子层） │ ├─ CognitiveModelBuilder │ ├─ CausalChainExtractor │ └─ ...（其他7个组件） │ ├─→ 双轨架构（协调层子层） │ ├─ 轨道A：语义桶提炼 │ ├─ 轨道B：链提取 │ └─ 融合层 │ ├─→ 存储层（基础层） │ ├─ ShortTermMemoryManager │ └─ LongTermMemoryManager │ └─→ 基础设施层（底层） ├─ type_defs ├─ encryption └─ monitoring ``` --- ## 中间层：协调层 协调层是系统的核心业务层，包含**认知模型层**、**双轨架构**和**其他协调模块**。 ### 认知模型层（核心业务逻辑）（新） 认知模型层是协调层的**核心**，负责构建和推理智能体的认知状态。 #### 核心组件 | 组件 | 职责 | 输入 | 输出 | |------|------|------|------| | **CognitiveModelBuilder** | 认知模型构建器 | 上下文、记忆数据 | CognitiveModel | | **CausalChainExtractor** | 因果链提取器 | 对话历史、事件流 | List[CausalChain] | | **KnowledgeGapIdentifier** | 知识缺口识别器 | 认知模型、当前任务 | List[KnowledgeGap] | | **RetrievalDecisionEngine** | 检索决策引擎 | 情境、Token预算 | RetrievalPlan | | **RetrievalQualityEvaluator** | 检索质量评估器 | 检索结果、情境 | QualityScore | | **StateConsistencyValidator** | 状态一致性校验器 | 认知模型、新状态 | ValidationResult | | **StateInferenceEngine** | 状态推理引擎 | 当前状态、行为模式 | PredictedState | | **CrossSessionMemoryLinker** | 跨会话关联器 | 当前会话、历史会话 | List[MemoryLink] | | **MemoryForgettingMechanism** | 遗忘机制 | 记忆条目、访问模式 | UpdatedMemory | #### 认知模型数据流（新） ``` 原始信息输入 │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 认知模型构建器 │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 信息组织与结构化 │ │ │ │ │ │ │ │ 输入: 原始对话、工具结果、检索结果、状态快照 │ │ │ │ 输出: 结构化认知模型 │ │ │ │ │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │任务上下文│ │已知事实 │ │知识缺口 │ │待决策项 │ │ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │已完成路径│ │待验证假设│ │因果链 │ │当前约束 │ │ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ to_context_string() → 模型可直接理解的上下文字符串 │ └─────────────────────────────┬───────────────────────────────┘ │ ┌───────────────┼───────────────┐ ▼ ▼ ▼ ┌───────────────┐ ┌───────────┐ ┌───────────────┐ │ 检索时机决策 │ │ 状态推理 │ │ 遗忘机制 │ │ 是否需要检索? │ │ 推断未知 │ │ 清理冷数据 │ └───────────────┘ └───────────┘ └───────────────┘ │ │ │ └───────────────┼───────────────┘ ▼ ┌───────────────┐ │ 模型决策 │ └───────────────┘ ``` #### 认知模型能力矩阵（新） | 能力 | 模块 | 核心功能 | |------|------|----------| | **认知模型构建** | CognitiveModelBuilder | 任务上下文、路径、约束、事实、假设、缺口、决策、链集（由双轨架构提取） | | **链提取** | CausalChainExtractor 等 | 因果链、逻辑链、操作链、叙事链、时间链提取 | | **知识缺口识别** | KnowledgeGapIdentifier | 已知/未知/假设分析，填充建议 | | **检索时机决策** | RetrievalDecisionEngine | 何时检索、检索什么、限流控制 | | **检索质量评估** | RetrievalQualityEvaluator | 6维度评估，二次检索决策 | | **状态一致性** | StateConsistencyValidator | 多模块状态校验，自动修复 | | **状态推理** | StateInferenceEngine | 演绎/归纳/溯因推理 | | **跨会话关联** | CrossSessionMemoryLinker | 会话知识图谱构建 | | **遗忘机制** | MemoryForgettingMechanism | 时间衰减+访问频率+重要性 | **链集说明**： - **因果链**（CausalChain）：问题→原因→解决方案 - **逻辑链**（LogicChain）：前提→推理→结论 - **操作链**（OperationChain）：动作→步骤→结果 - **叙事链**（NarrativeChain）：开端→发展→转折→结局 - **时间链**（TimeChain）：过去→现在→未来 链集由**双轨架构的轨道B**提取，为认知模型提供完整的结构化信息支撑。 ### 双轨架构（认知模型的具体实现层）（新） 双轨架构是协调层的**技术实现子层**，为认知模型层提供结构化信息提取能力。 #### 轨道A：语义桶提炼 负责将对话内容提炼为5种语义分类桶： | 语义桶 | 说明 | 映射到认知模型 | |--------|------|---------------| | **TASK_BUCKET** | 任务信息 | 为CognitiveModelBuilder提供任务上下文 | | **INTENT_BUCKET** | 意图信息 | 为StateInferenceEngine提供意图推理依据 | | **DECISION_BUCKET** | 决策信息 | 为CausalChainExtractor提供决策节点 | | **KNOWLEDGE_BUCKET** | 知识信息 | 为KnowledgeGapIdentifier提供知识库 | | **EMOTION_BUCKET** | 情感信息 | 为StateConsistencyValidator提供情感上下文 | #### 轨道B：链提取 负责提取5种类型的链： | 链类型 | 说明 | 服务对象 | 数据结构 | |--------|------|---------|---------| | **CAUSAL** | 因果链 | CausalChainExtractor、StateInferenceEngine | 问题→原因→解决方案 | | **LOGIC** | 逻辑链 | StateInferenceEngine、RetrievalDecisionEngine | 前提→推理→结论 | | **OPERATION** | 操作链 | CognitiveModelBuilder、CrossSessionMemoryLinker | 动作→步骤→结果 | | **NARRATIVE** | 叙事链 | CrossSessionMemoryLinker、StateConsistencyValidator | 开端→发展→转折→结局 | | **TIME** | 时间链 | StateConsistencyValidator、MemoryForgettingMechanism | 过去→现在→未来 | #### 融合层 负责将轨道A和轨道B的结果融合： | 融合模块 | 功能 | 输出 | |---------|------|------| | **BucketChainLinker** | 关联语义桶与链 | BucketChainRelation | | **CrossValidator** | 跨层验证 | ValidationResult | | **MultiDimensionSummary** | 多维摘要 | DimensionSummary | #### 双轨架构的数据流（新） ``` 对话输入 │ ├─────────────────────┐ │ │ ▼ ▼ ┌──────────┐ ┌──────────┐ │ 轨道A │ │ 轨道B │ │ 语义桶 │ │ 链提取 │ └──────────┘ └──────────┘ │ │ └──────────┬──────────┘ │ ▼ ┌──────────┐ │ 融合层 │ │ • 关联 │ │ • 验证 │ │ • 摘要 │ └──────────┘ │ ▼ 结构化认知信息 ``` ### 其他协调模块 | 模块 | 职责 | 服务对象 | |------|------|---------| | **ContextCompressor** | 上下文压缩 | ContextOrchestrator | | **MemoryConflict** | 冲突检测 | StateConsistencyValidator | | **ConflictResolver** | 冲突解析 | MemoryConflict | | **InsightModule** | 洞察生成 | CognitiveModelBuilder | | **StateCapture** | 状态捕捉 | CognitiveModelBuilder | --- ## 基础层：存储层 存储层负责所有记忆数据的持久化和索引管理。 ### 核心模块 | 模块 | 职责 | 支持的数据类型 | |------|------|---------------| | **ShortTermMemoryManager** | 短期记忆管理 | 对话消息、语义桶、链信息 | | **LongTermMemoryManager** | 长期记忆管理 | 用户画像、历史会话、工具效果 | | **MemoryIndexer** | 记忆索引 | 倒排索引、向量索引 | | **RedisAdapter** | Redis存储 | 缓存、临时数据 | | **chain_buffer.py** | 链缓冲区 | 提取的链信息 | ### 数据分类 #### 短期记忆分类 | 类型 | 说明 | 生命周期 | |------|------|---------| | **对话消息** | 原始对话内容 | 会话生命周期 | | **语义桶** | 提炼后的语义分类 | 短期（1-7天） | | **链信息** | 提取的链数据 | 短期（1-7天） | #### 长期记忆分类 | 类型 | 说明 | 生命周期 | |------|------|---------| | **身份信息** | 用户身份、角色 | 永久 | | **偏好信息** | 用户偏好、习惯 | 永久 | | **技能信息** | 用户技能、能力 | 永久 | | **行为信息** | 用户行为模式 | 长期 | | **情感信息** | 情感倾向 | 长期 | | **知识信息** | 领域知识 | 长期 | | **叙事信息** | 故事、经历 | 长期 | --- ## 底层：基础设施层 基础设施层提供系统运行所需的基础能力。 ### 核心模块 | 模块 | 职责 | |------|------| | **type_defs.py** | 类型定义（ContextBlock、MemoryItem、Chain等） | | **token_budget.py** | Token预算管理 | | **encryption.py** | 加密解密（AES-256-GCM） | | **privacy.py** | 隐私保护 | | **permission_boundary_controller.py** | 权限控制 | | **monitoring_system.py** | 监控系统 | | **LRUCache.py** | LRU缓存 | | **PerformanceMonitor.py** | 性能监控 | ### 安全保障 | 安全机制 | 实现方式 | |---------|---------| | **数据加密** | AES-256-GCM | | **隐私保护** | 敏感数据识别、脱敏 | | **权限控制** | 基于角色的访问控制 | | **审计追踪** | 操作日志、时间戳 | --- ## 目录 1. [系统定位与核心能力](#一系统定位与核心能力) 2. [模块架构](#二模块架构) 3. [核心数据流](#三核心数据流) 4. [记忆分类体系](#四记忆分类体系) 5. [提炼映射规则](#五提炼映射规则) 6. [六维质量评估](#六六维质量评估) 7. [场景与阶段类型](#七场景与阶段类型) 8. [洞察类型体系](#八洞察类型体系) 9. [模块连接优先级](#九模块连接优先级) 10. [性能指标](#十性能指标) 11. [认知模型层架构](#十一认知模型层架构) 12. [上下文来源优先级](#十二上下文来源优先级) 13. [检索决策流程](#十三检索决策流程) 14. [记忆演化机制](#十四记忆演化机制) 15. [敏感信息类型](#十五敏感信息类型) 16. [性能指标](#十六性能指标) 17. [上下文扩展类型](#十七上下文类型扩展)（混合方案）（新） 18. [上下文压缩架构](#十八上下文压缩架构)（新） --- ## 一、系统定位与核心能力 ### 定位 Agent Memory System 是**智能体一切行为的底层记忆基础设施**，作为元技能常驻运行（`always: true`）。 ### 核心能力矩阵 | 能力层 | 模块 | 核心功能 | |--------|------|----------| | **感知层** | 感知记忆 | 对话上下文存储、情境感知 | | **缓冲层** | 短期记忆 | 5种语义分类桶、洞察驱动提炼、跨层关联索引 | | **持久层** | 长期记忆 | 7种记忆分类、冷热度分层管理 | | **激活层** | 上下文重构器 | 六维激活器、六维质量评估、比重适配 | | **洞察层** | 独立洞察模块 | 洞察池、超然观察者、9种洞察类型 | | **状态层** | 全局状态捕捉器 | 场景识别、阶段追踪、用户状态感知 | | **安全层** | 隐私配置 + 数据加密 | 敏感数据识别、用户同意管理、AES-256-GCM 加密 | | **效率层** | 记忆索引 + 增量同步 | 倒排索引、提炼状态追踪 | --- ## 二、模块架构 ### 模块协作图 ``` 用户交互 │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 感知记忆模块 │ │ • 对话上下文存储 • 情境感知 • 隐私检查 │ └─────────────────────────────┬───────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 短期记忆模块 │ │ • 5种语义分类桶（任务/意图/决策/知识/情感） │ │ • 洞察驱动提炼 ──────────────────────┐ │ │ • 跨层关联索引 ──[关联检索]──→ 长期记忆 │ └─────────────────────────────┬───────────────────────────────┘ │ ┌─────────────────────┼─────────────────────┐ │ │ │ ▼ ▼ ▼ ┌───────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ 长期记忆 │ │ 上下文重构器 │ │ 洞察模块 │ │ │ │ │ │ │ │ 核心层: │ │ • 六维激活器 │ │ • 洞察池 │ │ 身份/偏好/ │◀──│ • 六维质量评估 │◀──│ • 超然观察者 │ │ 技能 │ │ • 比重适配 │ │ • 状态模式分析 │ │ │ │ │ │ │ │ 扩展层: │ └────────┬────────┘ └────────┬────────┘ │ 行为/情感/ │ │ │ │ 知识/叙事 │ └──────────┬──────────┘ └───────────────┘ │ ▼ ┌─────────────────┐ │ 模型决策响应 │ └─────────────────┘ ┌─────────────────────────────────────────────────────────────┐ │ 全局状态捕捉器 │ │ • LangGraph 集成 • 状态同步 • 检查点管理 • 时间旅行 │ │ • 事件订阅：PHASE_CHANGE / TASK_SWITCH / USER_STATE_CHANGE │ └─────────────────────────────────────────────────────────────┘ │ │ P0/P1 连接 ▼ ┌─────────┬─────────┬─────────────┬───────────────┐ │工具管理 │短期记忆 │上下文重构器 │ 洞察模块 │ └─────────┴─────────┴─────────────┴───────────────┘ ``` ### 2.1 核心模块职责 | 模块 | 职责 | 输入 | 输出 | |------|------|------|------| | 感知记忆 | 对话存储、情境感知 | 用户消息、系统响应 | 会话ID、情境对象 | | 短期记忆 | 语义分类、话题聚合、提炼触发 | 消息内容、语义类型 | 记忆项、提炼建议 | | 长期记忆 | 持久化存储、热度管理、工具效果 | 提炼条目 | 记忆条目、推荐结果 | | 上下文重构器 | 记忆激活、质量评估、上下文包构建 | 情境、长期记忆 | 上下文包 | | 洞察模块 | 模式识别、建议生成 | 上下文包、记忆数据 | 洞察列表 | | 状态捕捉器 | 状态同步、事件发布 | LangGraph 状态 | 检查点、事件流 | ### 2.2 架构分层概述（新） | 层级 | 职责 | 核心模块 | |------|------|---------| | **顶层：总控层** | 统一入口、全局调度、资源管理 | ContextOrchestrator | | **中间层：协调层** | 认知处理、双轨实现、信息整合 | 认知模型层、双轨架构、其他协调模块 | | **基础层：存储层** | 记忆持久化、索引管理、缓存 | ShortTermMemory、LongTermMemory、MemoryIndexer | | **底层：基础设施层** | 类型定义、加密隐私、监控优化 | type_defs、encryption、privacy、monitoring | ### 2.3 层间交互原则（新） - **自上而下调用**：总控层 → 协调层 → 存储层 → 基础设施层 - **自下而上反馈**：基础设施层 → 存储层 → 协调层 → 总控层 - **认知模型层为核心**：双轨架构为认知模型层提供技术实现支撑 --- ## 三、核心数据流 ### 主数据流（记忆存储路径） ``` 用户消息 │ ▼ ┌─────────────────┐ │ 隐私检查 │ ← PrivacyManager │ 敏感数据识别 │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ 感知记忆存储 │ ← PerceptionMemoryStore │ 会话创建 │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ 短期记忆分类 │ ← ShortTermMemoryManager │ 智能体指定语义桶│ │ 话题标签 │ └────────┬────────┘ │ ┌────┴────┐ ▼ ▼ ┌───────┐ ┌─────────────────┐ │ 提炼 │ │ 跨层索引 │ │ 条目 │ │ 关联长期记忆 │ └───┬───┘ └─────────────────┘ │ ▼ ┌─────────────────┐ │ 类型映射 │ │ DECISION→不存储 │ │ 其他→长期分类 │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ 长期记忆持久化 │ ← LongTermMemoryManager │ 冷热度分层 │ └─────────────────┘ ``` ### 激活数据流（记忆检索路径） ``` 当前情境 │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 上下文重构器 │ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ 时间激活器 │ │ 语义激活器 │ │ 情境激活器 │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ 情感激活器 │ │ 因果激活器 │ │ 身份激活器 │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────┐ │ │ │ 六维质量评估 │ │ │ │ 相关性/完整性 │ │ │ │ 连贯性/时效性 │ │ │ │ 多样性/可操作性│ │ │ └────────┬────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────┐ │ │ │ 比重适配 │ ← 根据场景调整权重 │ │ └────────┬────────┘ │ │ │ │ └───────────────────────┼─────────────────────────────────────┘ │ ▼ ┌───────────────┐ │ 上下文包 │ └───────────────┘ │ ┌────────────┼────────────┐ ▼ ▼ ▼ ┌────────────┐ ┌──────────┐ ┌──────────┐ │ 洞察生成 │ │ 工具推荐 │ │ 模型响应 │ └────────────┘ └──────────┘ └──────────┘ ``` ### 状态事件流（P0/P1 连接） ``` LangGraph 节点执行 │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 全局状态捕捉器 │ │ │ │ sync_from_langgraph(state, node_name, thread_id) │ │ │ │ │ ├──▶ 检查点存储 (Checkpoint) │ │ │ │ │ ├──▶ 状态差异计算 (State Diff) │ │ │ │ │ └──▶ 事件发布 (Event Bus) │ │ │ │ └────────────────────┼────────────────────────────────────────┘ │ ┌───────────┼───────────┬───────────────┐ ▼ ▼ ▼ ▼ ┌─────────┐ ┌─────────┐ ┌──────────┐ ┌──────────────┐ │短期记忆 │ │上下文 │ │ 长期记忆 │ │ 洞察模块 │ │自动存储 │ │重构器 │ │ 提炼触发 │ │ 状态模式分析 │ │(P1) │ │(P0) │ │ │ │ (P1) │ └─────────┘ └─────────┘ └──────────┘ └──────────────┘ ``` --- 三种记忆类型与数据流转 Agent Memory System 采用**三种记忆类型**的层级架构，从感知到持久化形成完整的数据流转。 ### 3.1 三种记忆类型概览（新） ``` ┌─────────────────────────────────────────────────────────────────┐ │ 记忆类型层级架构 │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 1. 感知记忆（Perception Memory） │ │ │ │ • 定位：对话上下文存储、情境感知 │ │ │ │ • 生命周期：会话级别（随会话结束而清除） │ │ │ │ • 存储内容：原始对话消息、系统指令、工具调用 │ │ │ │ • 特点：临时性、实时性、无需结构化 │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 2. 短期记忆（Short-Term Memory） │ │ │ │ • 定位：语义分类桶、洞察驱动提炼 │ │ │ │ • 生命周期：短期（1-7天，按热度衰减） │ │ │ │ • 存储内容：5种语义桶（任务/意图/决策/知识/情感）+ 链信息 │ │ │ │ • 特点：结构化、可提炼、关联索引 │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 3. 长期记忆（Long-Term Memory） │ │ │ │ • 定位：持久化存储、冷热度分层管理 │ │ │ │ • 生命周期：永久或长期（按访问频率和重要性管理） │ │ │ │ • 存储内容：7种分类（身份/偏好/技能/行为/情感/知识/叙事） │ │ │ │ • 特点：持久化、索引化、跨会话关联 │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ### 3.2 感知记忆（Perception Memory） **定位**：对话上下文存储、情境感知 **存储内容**： - 用户输入消息 - 系统回复消息 - 工具调用记录 - 系统指令 **生命周期**：会话级别（随会话结束而清除） **特点**： - 临时性：不需要长期保存 - 实时性：实时记录所有交互 - 无需结构化：原始消息格式 **管理模块**： - `PerceptionMemoryStore` - 感知记忆存储 - `SessionManager` - 会话管理 ### 3.3 短期记忆（Short-Term Memory） **定位**：语义分类桶、洞察驱动提炼 **存储内容**： - **5种语义桶**： - TASK_BUCKET（任务信息） - INTENT_BUCKET（意图信息） - DECISION_BUCKET（决策信息） - KNOWLEDGE_BUCKET（知识信息） - EMOTION_BUCKET（情感信息） - **链信息**： - 因果链（CAUSAL） - 逻辑链（LOGIC） - 操作链（OPERATION） - 叙事链（NARRATIVE） - 时间链（TIME） - **话题标签**：用于聚合相同话题的内容 **生命周期**：短期（1-7天，按热度衰减） **特点**： - 结构化：智能体指定语义桶类型 - 可提炼：可被提炼为长期记忆 - 关联索引：跨层关联长期记忆 **管理模块**： - `ShortTermMemoryManager` - 短期记忆管理 - `TopicCluster` - 话题簇管理 - `ShortTermRedis` - Redis存储 ### 3.4 长期记忆（Long-Term Memory） **定位**：持久化存储、冷热度分层管理 **存储内容**： - **核心层（持久化）**： - CORE_IDENTITY（核心身份） - CORE_PREFERENCE（核心偏好） - CORE_SKILL（核心技能） - **扩展层（动态更新）**： - EXTENDED_BEHAVIOR（扩展行为） - EXTENDED_EMOTION（扩展情感） - EXTENDED_KNOWLEDGE（扩展知识） - EXTENDED_NARRATIVE（扩展叙事） **生命周期**：永久或长期（按访问频率和重要性管理） **特点**： - 持久化：跨会话保持 - 索引化：支持快速检索 - 跨会话关联：支持会话知识图谱 **管理模块**： - `LongTermMemoryManager` - 长期记忆管理 - `MemoryIndexer` - 记忆索引 - `CrossSessionMemoryLinker` - 跨会话关联 ### 3.5 数据流转关系（新） ``` ┌─────────────────────────────────────────────────────────────────┐ │ 记忆数据流转完整流程 │ │ │ │ ┌─────────────┐ │ │ │ 用户消息 │ │ │ └──────┬──────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 1. 感知记忆存储（Perception Memory Store） │ │ │ │ • 原始消息存储 │ │ │ │ • 会话上下文构建 │ │ │ │ • 情境感知记录 │ │ │ └────────────────────┬────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 2. 隐私检查（PrivacyManager） │ │ │ │ • 敏感数据识别 │ │ │ │ • 过滤动作（REDACT/MASK/SKIP） │ │ │ └────────────────────┬────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 3. 短期记忆分类（ShortTermMemoryManager） │ │ │ │ • 智能体指定语义桶类型 │ │ │ │ • 5种语义分类桶存储 │ │ │ │ • 话题标签指定 │ │ │ └────────────────────┬────────────────────────────────────┘ │ │ │ │ │ ┌─────────────┼─────────────┐ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ 提炼触发 │ │ 跨层索引 │ │ 链提取 │ │ │ │ 洞察驱动 │ │ 关联检索 │ │ 双轨轨道B│ │ │ └─────┬────┘ └─────┬────┘ └─────┬────┘ │ │ │ │ │ │ │ └─────────────┼─────────────┘ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 4. 类型映射与提炼（Refinement Trigger） │ │ │ │ • 短期语义桶 → 长期记忆分类 │ │ │ │ • DECISION_BUCKET → 不存储（临时决策） │ │ │ │ • 冷热度评估、频率统计 │ │ │ └────────────────────┬────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 5. 长期记忆持久化（LongTermMemoryManager） │ │ │ │ • 7种记忆分类存储 │ │ │ │ • 冷热度分层管理 │ │ │ │ • 记忆索引构建 │ │ │ └────────────────────┬────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 6. 遗忘机制（MemoryForgettingMechanism） │ │ │ │ • 时间衰减 │ │ │ │ • 访问频率评估 │ │ │ │ • 重要性评分 │ │ │ └────────────────────┬────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 7. 记忆检索（Retrieval Decision Engine） │ │ │ │ • 检索时机决策 │ │ │ │ • 检索范围确定 │ │ │ │ • 结果质量评估 │ │ │ └────────────────────┬────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 8. 上下文重构（ContextOrchestrator） │ │ │ │ • 多源记忆整合 │ │ │ │ • 上下文压缩 │ │ │ │ • Token预算管理 │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ### 记忆检索路径 ``` 当前情境 │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ ContextOrchestrator（总控层） │ │ │ │ 1. Token预算评估 │ │ 2. 检索决策 │ │ 3. 调用认知模型层 │ │ 4. 调用双轨架构（如需要） │ │ 5. 多源整合 │ │ 6. 结果压缩 │ └─────────────────────────────────────────────────────────────┘ │ ├─→ 认知模型层（协调层子层） │ ├─ CognitiveModelBuilder │ ├─ CausalChainExtractor │ └─ ...（其他7个组件） │ ├─→ 双轨架构（协调层子层） │ ├─ 轨道A：语义桶提炼 │ ├─ 轨道B：链提取 │ └─ 融合层 │ └─→ 存储层（基础层） ├─ ShortTermMemoryManager └─ LongTermMemoryManager ``` ### 3.6 提炼映射规则 | 短期语义桶 | 长期记忆类型 | 说明 | 触发条件 | |-----------|------------|------|---------| | **TASK_BUCKET** | EXTENDED_BEHAVIOR | 行为信息（任务完成情况、习惯） | 热度高、频率高 | | **INTENT_BUCKET** | EXTENDED_PREFERENCE | 偏好信息（意图模式、偏好） | 热度高、频率高 | | **DECISION_BUCKET** | 不存储 | 临时决策，不长期存储 | 永不提炼 | | **KNOWLEDGE_BUCKET** | EXTENDED_KNOWLEDGE | 知识信息（领域知识、概念） | 热度高、重要性高 | | **EMOTION_BUCKET** | EXTENDED_EMOTION | 情感信息（情感倾向、模式） | 频率高、模式明显 | ### 3.7 记忆层级对比 | 特性 | 感知记忆 | 短期记忆 | 长期记忆 | |------|---------|---------|---------| | **生命周期** | 会话级别 | 1-7天 | 永久或长期 | | **存储格式** | 原始消息 | 结构化（语义桶+链） | 分类（7种） | | **提炼能力** | 无 | 可提炼到长期记忆 | 不可提炼 | | **关联能力** | 无 | 跨层关联长期记忆 | 跨会话关联 | | **检索速度** | 最快 | 快 | 中等（需要索引） | | **使用场景** | 实时对话、情境感知 | 近期上下文、知识积累 | 用户画像、历史回顾 | --- ## 四、记忆分类体系 ### 短期记忆语义分类桶（5种） **语义分类由智能体判断**，智能体根据对话内容理解后，调用 `store_with_semantics()` 指定： | 桶类型 | 判断标准 | 优先级 | 示例 | |--------|----------|--------|------| | TASK_CONTEXT | 与当前任务直接相关 | 0.9 | "实现用户登录功能" | | USER_INTENT | 表达意图、目标、需求 | 0.85 | "想要一个记忆系统" | | DECISION_CONTEXT | 选择、决定、方案 | 0.8 | "选择PostgreSQL" | | KNOWLEDGE_GAP | 表达不知道、疑问 | 0.7 | "不知道如何实现SSO" | | EMOTIONAL_TRACE | 表达情绪、感受 | 0.6 | "对进度感到焦虑" | **话题标签**：智能体同时指定话题标签（如 "用户登录"），用于聚合相同话题的内容。 ### 长期记忆7种分类 ``` ┌─────────────────────────────────────────────────────────────┐ │ 长期记忆7分类体系 │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 【核心层】持久化，跨会话稳定 │ │ ├── CORE_IDENTITY 核心身份 → UserProfile.identity │ │ ├── CORE_PREFERENCE 核心偏好 → UserProfile.preferences │ │ └── CORE_SKILL 核心技能 → ProceduralMemory │ │ │ │ 【扩展层】动态更新，跨会话积累 │ │ ├── EXTENDED_BEHAVIOR 扩展行为 → ProceduralMemory │ │ ├── EXTENDED_EMOTION 扩展情感 → EmotionalMemory │ │ ├── EXTENDED_KNOWLEDGE 扩展知识 → SemanticMemory │ │ └── EXTENDED_NARRATIVE 扩展叙事 → NarrativeMemory │ │ │ │ 注意：上下文（Context）是动态的、会话级别的， │ │ 由短期记忆和上下文重构器管理，不属于长期记忆。 │ │ │ └─────────────────────────────────────────────────────────────┘ ``` --- ## 五、提炼映射规则 ### 映射表 | 短期桶 | 目标 | 处理方式 | 说明 | |--------|------|----------|------| | USER_INTENT | CORE_PREFERENCE | 长期存储 | 用户偏好应持久化 | | USER_INTENT | CORE_IDENTITY | 长期存储 | 涉及身份认同时 | | DECISION_CONTEXT | CONTEXT_ACTIVATION | **不存储** | 传递给上下文重构器 | | TASK_CONTEXT | EXTENDED_NARRATIVE | 长期存储 + 激活 | 双重用途 | | KNOWLEDGE_GAP | EXTENDED_KNOWLEDGE | 长期存储 | 知识应持久化 | | EMOTIONAL_TRACE | EXTENDED_EMOTION | 长期存储 | 情感应持久化 | ### 决策上下文处理原则 ``` 场景示例：用户说 "我选择用 PostgreSQL" 【错误做法】直接存储到长期记忆 → 长期记忆中出现大量"选择X"的碎片 → 没有上下文，无法理解为什么选择 【正确做法】传递给上下文重构器 → 激活相关记忆：电商系统项目、数据库需求 → 结合当前情境理解决策 → 形成有意义的上下文包 → 决策结果体现在叙事记忆中（任务完成时） ``` ### 映射规则（新） | 短期语义桶 | 长期记忆类型 | 说明 | |-----------|------------|------| | **TASK_BUCKET** | 行为信息 | 任务完成情况、习惯 | | **INTENT_BUCKET** | 偏好信息 | 意图模式、偏好 | | **DECISION_BUCKET** | 行为信息 | 决策模式、偏好 | | **KNOWLEDGE_BUCKET** | 知识信息 | 领域知识、概念 | | **EMOTION_BUCKET** | 情感信息 | 情感倾向、模式 | ### 不存储类型（新） | 短期语义桶 | 说明 | |-----------|------| | **DECISION_BUCKET** | 临时决策，不长期存储 | --- ## 六、六维质量评估 上下文重构器使用六维质量评估来筛选和排序记忆： | 维度 | 说明 | 权重范围 | 场景适配 | |------|------|----------|----------| | 相关性 | 与当前任务的相关程度 | 0.15-0.30 | 编码场景权重高 | | 完整性 | 信息覆盖的完整程度 | 0.15-0.25 | 分析场景权重高 | | 连贯性 | 信息间的逻辑连贯性 | 0.10-0.20 | 设计场景权重高 | | 时效性 | 信息的时效程度 | 0.10-0.20 | 调试场景权重高 | | 多样性 | 信息来源的多样性 | 0.05-0.30 | 学习场景权重高 | | 可操作性 | 转化为行动的可能性 | 0.10-0.20 | 实现场景权重高 | **比重适配**：根据 `GlobalStateCapture` 识别的场景类型动态调整权重。 ### 六维评估（新） | 维度 | 说明 | 评估方法 | |------|------|---------| | **相关性** | 与当前情境的关联度 | 语义相似度 | | **完整性** | 信息的完整程度 | 必需字段检查 | | **连贯性** | 信息之间的逻辑一致性 | 因果链验证 | | **时效性** | 信息的时效性 | 时间衰减 | | **多样性** | 信息类型的多样性 | 类别分布 | | **可操作性** | 信息对决策的支持程度 | 因果强度 | --- ## 七、场景与阶段类型 ### 场景类型（ScenarioType） | 场景 | 说明 | 激活权重偏好 | |------|------|--------------| | CODING | 编码场景 | 相关性↑、可操作性↑ | | DEBUGGING | 调试场景 | 时效性↑、相关性↑ | | DESIGN | 设计场景 | 连贯性↑、完整性↑ | | ANALYSIS | 分析场景 | 完整性↑、多样性↑ | | LEARNING | 学习场景 | 多样性↑、完整性↑ | | PLANNING | 规划场景 | 连贯性↑、相关性↑ | | REVIEW | 审查场景 | 完整性↑、时效性↑ | ### 阶段类型（PhaseType） | 阶段 | 说明 | 典型状态变化 | |------|------|--------------| | EXPLORATION | 探索阶段 | 频繁 TASK_SWITCH | | DESIGN | 设计阶段 | 稳定 PHASE_CHANGE | | IMPLEMENTATION | 实现阶段 | 高频 TOOL_CALL | | VERIFICATION | 验证阶段 | USER_STATE 变化 | | COMPLETION | 完成阶段 | TASK_COMPLETE | ### 场景类型（新） | 场景 | 说明 | 激活维度 | |------|------|---------| | **编程** | 代码开发 | 知识、任务 | | **写作** | 内容创作 | 情感、叙事 | | **分析** | 数据分析 | 逻辑、因果 | | **对话** | 日常对话 | 情感、意图 | | **决策** | 决策支持 | 决策、因果 | ### 阶段类型（新） | 阶段 | 说明 | 检索重点 | |------|------|---------| | **启动** | 开始阶段 | 身份、偏好 | | **进行** | 执行阶段 | 任务、知识 | | **结束** | 完成阶段 | 结果、情感 | | **中断** | 暂停阶段 | 状态、进度 | --- ## 八、洞察类型体系 ### 9种洞察类型 | 类型 | 说明 | 优先级规则 | 可执行性 | |------|------|------------|----------| | USER_PREFERENCE | 用户偏好发现 | 置信度 >= 0.85 → HIGH | 否 | | BEHAVIORAL_PATTERN | 行为模式识别 | 置信度 >= 0.85 → HIGH | 否 | | BEST_PRACTICE | 最佳实践建议 | - | 是 | | EFFICIENCY_OPPORTUNITY | 效率提升机会 | - | 是 | | KNOWLEDGE_GAP | 知识缺口提示 | 置信度 >= 0.7 → MEDIUM | 否 | | PROCESS_IMPROVEMENT | 流程改进建议 | - | 是 | | ERROR_PREVENTION | 错误预防提醒 | - | 是 | | EMOTIONAL_PATTERN | 情感模式洞察 | - | 否 | | IDENTITY_EVOLUTION | 身份演化追踪 | - | 否 | ### 洞察池状态流转 ``` ACTIVE（活跃）──▶ PENDING（待处理）──▶ ARCHIVED（归档） │ │ │ └──▶ 验证失败 ──▶ ACTIVE │ └──▶ 过期/失效 ──▶ ARCHIVED ``` ### P1新增：状态模式分析洞察 绑定 `GlobalStateCapture` 后，洞察模块自动分析： | 分析维度 | 洞察内容 | 优先级 | |----------|----------|--------| | 阶段切换效率 | 各阶段停留时间、效率瓶颈识别 | MEDIUM | | 状态优化建议 | 基于历史数据的状态流转优化 | HIGH | | 用户状态影响 | 用户状态对任务成功率的影响 | HIGH | ### 9种洞察类型（新） | 类型 | 说明 | 触发条件 | |------|------|---------| | **偏好洞察** | 用户偏好识别 | 偏好模式发现 | | **习惯洞察** | 行为习惯识别 | 重复行为模式 | | **能力洞察** | 用户能力识别 | 技能表现分析 | | **情感洞察** | 情感状态识别 | 情感模式分析 | | **知识洞察** | 知识缺口识别 | 知识缺失检测 | | **冲突洞察** | 内部冲突识别 | 矛盾信息检测 | | **动机洞察** | 动机推断 | 行为动机分析 | | **机会洞察** | 机会识别 | 潜在机会检测 | | **风险洞察** | 风险识别 | 潜在风险检测 | --- ## 九、模块连接优先级 ### P0 层（已完成） | 连接 | 说明 | 实现方式 | |------|------|----------| | 工具状态关联 | 工具使用记录关联状态快照 | `update_tool_usage(checkpoint_id, phase, scenario, user_state)` | | 上下文重构器集成 | 根据场景调整激活权重 | `reconstructor.bind_state_capture(capture)` | ### P1 层（已完成） | 连接 | 说明 | 实现方式 | |------|------|----------| | 短期记忆事件驱动存储 | 状态变化自动触发记忆存储 | `short_term.bind_state_capture(capture, auto_store=True)` | | 洞察模块状态模式分析 | 分析状态变化模式生成洞察 | `insight_module.bind_state_capture(capture)` | ### P2 层（规划中） | 连接 | 说明 | 预期收益 | |------|------|----------| | 感知记忆情境增强 | 状态感知的情境识别 | 更精准的情境判断 | | 长期记忆热度联动 | 状态感知的热度计算 | 更智能的记忆优先级 | ### 连接优先级（新） | 优先级 | 连接 | 说明 | |-------|------|------| | **P0** | ContextOrchestrator → 认知模型层 | 核心路径 | | **P0** | ContextOrchestrator → 存储层 | 核心路径 | | **P1** | 认知模型层 → 双轨架构 | 关键路径 | | **P1** | 双轨架构 → 存储层 | 关键路径 | | **P2** | 洞察模块 → 认知模型层 | 优化路径 | --- ## 十、性能指标 | 模块 | 目标延迟 | 备注 | |------|----------|------| | 感知记忆存储 | < 10ms | 含隐私检查 | | 短期记忆存储 | < 5ms | 语义分类 | | 热记忆检索 | < 5ms | 索引命中 | | 冷记忆检索 | < 50ms | 磁盘读取 | | 上下文重构 | < 50ms | 六维激活 | | 洞察生成 | < 30ms | 单次处理 | | 状态同步 | < 10ms | LangGraph 集成 | | 端到端同步路径 | < 200ms | 完整流程 | ### 核心指标（新） | 指标 | 目标值 | 说明 | |------|-------|------| | **检索延迟** | < 100ms | 平均检索时间 | | **存储延迟** | < 50ms | 平均存储时间 | | **压缩比** | > 60% | 上下文压缩比 | | **缓存命中率** | > 80% | LRU缓存命中率 | | **内存占用** | < 200MB | 运行时内存 | --- ## 十一、认知模型层级架构（Part 3 新增） ### 层级分层架构 ``` ┌─────────────────────────────────────────────────────────────┐ │ 顶层：编排层 │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ Context Orchestrator（总控） │ │ │ │ • Token Budget Manager • 多源协调器 │ │ │ │ • 检索时机决策 • 结果压缩调度 │ │ │ │ • 认知模型构建 • 可观测性管理 │ │ │ └─────────────────────────────────────────────────────┘ │ ├─────────────────────────────────────────────────────────────┤ │ 认知模型层（Part 3 新增） │ │ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ │ │Cognitive │ │CausalChain │ │KnowledgeGap │ │ │ │ModelBuilder │ │Extractor │ │Identifier │ │ │ │ 认知模型构建 │ │ 因果链提取 │ │ 知识缺口识别 │ │ │ └────────────────┘ └────────────────┘ └────────────────┘ │ │ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ │ │Retrieval │ │State │ │State │ │ │ │DecisionEngine │ │Consistency │ │Inference │ │ │ │ 检索时机决策 │ │ 状态一致性校验 │ │ 状态推理引擎 │ │ │ └────────────────┘ └────────────────┘ └────────────────┘ │ │ ┌────────────────┐ ┌────────────────┐ │ │ │CrossSession │ │Memory │ │ │ │MemoryLinker │ │Forgetting │ │ │ │ 跨会话关联 │ │ 遗忘机制 │ │ │ └────────────────┘ └────────────────┘ │ ├─────────────────────────────────────────────────────────────┤ │ 中间层：协调层 │ │ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ │ │GlobalState │ │ChainReasoning │ │Context │ │ │ │Capture │ │Enhancer │ │Reconstructor │ │ │ └────────────────┘ └────────────────┘ └────────────────┘ │ ├─────────────────────────────────────────────────────────────┤ │ 基础层：存储层 │ │ ┌────────────┐ ┌────────────┐ ┌────────────────────┐ │ │ │ Perception │ │ ShortTerm │ │ LongTerm │ │ │ │ Memory │ │ Memory │ │ (8分类+反思记忆) │ │ │ └────────────┘ └────────────┘ └────────────────────┘ │ ├─────────────────────────────────────────────────────────────┤ │ 底层：基础设施 │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ Redis Layer │ │ │ │ • Hash+TTL（短期记忆） • Sorted Set（热度排序） │ │ │ │ • Pub/Sub（事件传播） • INCR（Token计数） │ │ │ └─────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────┘ ``` ### 认知模型能力矩阵 | 能力 | 模块 | 核心功能 | |------|------|----------| | **认知模型构建** | CognitiveModelBuilder | 任务上下文、路径、约束、事实、假设、缺口、决策、因果链 | | **因果链提取** | CausalChainExtractor | 问题→原因→解决方案链提取 | | **知识缺口识别** | KnowledgeGapIdentifier | 已知/未知/假设分析，填充建议 | | **检索时机决策** | RetrievalDecisionEngine | 何时检索、检索什么、限流控制 | | **检索质量评估** | RetrievalQualityEvaluator | 6维度评估，二次检索决策 | | **状态一致性** | StateConsistencyValidator | 多模块状态校验，自动修复 | | **状态推理** | StateInferenceEngine | 演绎/归纳/溯因推理 | | **跨会话关联** | CrossSessionMemoryLinker | 会话知识图谱构建 | | **遗忘机制** | MemoryForgettingMechanism | 时间衰减+访问频率+重要性 | ### 认知模型数据流 ``` 原始信息输入 │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 认知模型构建器 │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 信息组织与结构化 │ │ │ │ │ │ │ │ 输入: 原始对话、工具结果、检索结果、状态快照 │ │ │ │ 输出: 结构化认知模型 │ │ │ │ │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │任务上下文│ │已知事实 │ │知识缺口 │ │待决策项 │ │ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │已完成路径│ │待验证假设│ │因果链 │ │当前约束 │ │ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ to_context_string() → 模型可直接理解的上下文字符串 │ └─────────────────────────────┬───────────────────────────────┘ │ ┌───────────────┼───────────────┐ ▼ ▼ ▼ ┌───────────────┐ ┌───────────┐ ┌───────────────┐ │ 检索时机决策 │ │ 状态推理 │ │ 遗忘机制 │ │ 是否需要检索? │ │ 推断未知 │ │ 清理冷数据 │ └───────────────┘ └───────────┘ └───────────────┘ │ │ │ └───────────────┼───────────────┘ ▼ ┌───────────────┐ │ 模型决策 │ └───────────────┘ ``` --- ## 十二、上下文来源优先级（Part 3.5 新增） ### 九类上下文来源 | 来源类型 | 优先级 | 说明 | |----------|--------|------| | SYSTEM_INSTRUCTION | 100 | 系统指令，定义行为边界 | | PERMISSION_CONSTRAINT | 99 | 权限约束，安全边界 | | USER_QUERY | 95 | 用户当前问题，触发点 | | TASK_STATE | 85 | 任务状态，进度追踪 | | CONVERSATION_HISTORY | 80 | 历史对话，决策轨迹 | | TOOL_OUTPUT | 75 | 工具返回，执行结果 | | RETRIEVAL_RESULT | 70 | 检索结果，知识补充 | | USER_PREFERENCE | 60 | 用户偏好，个性化 | | LONG_TERM_MEMORY | 50 | 长期记忆，持续协作 | ### 来源优先级（新） | 来源 | 优先级 | 说明 | |------|-------|------| | **短期记忆** | 最高 | 最近信息 | | **长期记忆** | 高 | 核心信息 | | **认知模型** | 中 | 推理信息 | | **双轨架构** | 中 | 结构化信息 | | **外部知识** | 低 | 补充信息 | --- ## 十三、检索决策流程（Part 3.2 新增） ### 检索需求级别 | 级别 | 触发条件 | 建议动作 | |------|----------|----------| | REQUIRED | 知识覆盖率低、不确定性高、故障排查 | 立即检索 | | RECOMMENDED | 复杂查询、知识边界外 | 建议检索 | | OPTIONAL | 探索性查询、已有知识可能足够 | 可选检索 | | UNNECESSARY | 简单查询、已有知识足够 | 不检索 | | CACHED | 缓存命中 | 使用缓存 | ### 检索策略选择 | 查询类型 | 推荐策略 | 说明 | |----------|----------|------| | TROUBLESHOOTING | HYBRID | 混合检索，兼顾精确与语义 | | CONCEPTUAL | VECTOR_ONLY | 向量优先，语义匹配 | | PROCEDURAL | KEYWORD_ONLY | 关键词优先，精确匹配 | | EXPLORATORY | MULTI_PATH | 多路召回，广泛覆盖 | | FACTUAL | HYBRID | 混合检索 | ### 检索质量维度 | 维度 | 权重 | 说明 | |------|------|------| | RELEVANCE | 30% | 相关性 | | COMPLETENESS | 20% | 完整性 | | FRESHNESS | 15% | 新鲜度 | | DIVERSITY | 15% | 多样性 | | COHERENCE | 10% | 连贯性 | | CREDIBILITY | 10% | 可信度 | ### 决策流程（新） ``` 情境分析 │ ▼ Token预算评估 │ ▼ 检索范围确定 │ ├─→ 短期记忆（始终检索） ├─→ 长期记忆（按优先级） ├─→ 认知模型（如需要） └─→ 双轨架构（如需要） │ ▼ 检索执行 │ ▼ 质量评估 │ ▼ 结果整合 │ ▼ 上下文重构 │ ▼ 最终输出 ``` --- ## 十四、记忆演化机制（Part 3.4 新增） ### 跨会话关联类型 | 类型 | 说明 | 强度 | |------|------|------| | SAME_TASK | 同一任务的不同会话 | STRONG | | SAME_TOPIC | 相同主题 | MEDIUM | | SAME_ENTITY | 共享实体 | MEDIUM | | CONTINUATION | 延续关系 | STRONG | | REFERENCE | 引用关系 | WEAK | | COMPLEMENT | 互补关系 | MEDIUM | ### 记忆重要性分级 | 级别 | 说明 | 遗忘策略 | |------|------|----------| | CRITICAL | 关键：永不遗忘 | 永久保护 | | HIGH | 高：长期保留 | 延迟遗忘 | | MEDIUM | 中：中期保留 | 正常遗忘 | | LOW | 低：短期保留 | 快速遗忘 | | TRIVIAL | 琐碎：快速遗忘 | 优先遗忘 | ### 遗忘触发因素 | 因素 | 权重 | 说明 | |------|------|------| | TIME_DECAY | 40% | 时间衰减 | | LOW_ACCESS | 30% | 低访问频率 | | IRRELEVANCE | 20% | 不相关性 | | REDUNDANCY | 10% | 冗余 | ### 演化流程（新） ``` 短期记忆 │ ├─→ 热度评估 ├─→ 频率统计 └─→ 价值判断 │ ▼ 提炼触发 │ ├─→ 类型映射 ├─→ 冷热分层 └─→ 持久化 │ ▼ 长期记忆 │ ├─→ 冷热度管理 ├─→ 遗忘机制 └─→ 更新维护 ``` --- ## 十五、敏感信息类型（Part 3.5 新增） | 类型 | 描述 | 过滤动作 | |------|------|----------| | API_KEY | API密钥 | REDACT（替换为[REDACTED]） | | PASSWORD | 密码 | MASK（部分掩码） | | TOKEN | 访问令牌 | REDACT | | CREDIT_CARD | 信用卡号 | MASK | | EMAIL | 电子邮箱 | REDACT | | PHONE | 电话号码 | REDACT | | IP_ADDRESS | IP地址 | MASK | | PERSONAL_ID | 身份证号 | MASK | --- ## 十六、性能指标（更新） | 模块 | 目标延迟 | 备注 | |------|----------|------| | 感知记忆存储 | < 10ms | 含隐私检查 | | 短期记忆存储 | < 5ms | 语义分类 | | 热记忆检索 | < 5ms | 索引命中 | | 冷记忆检索 | < 50ms | 磁盘读取 | | 上下文重构 | < 50ms | 六维激活 | | 洞察生成 | < 30ms | 单次处理 | | 状态同步 | < 10ms | LangGraph 集成 | | **认知模型构建** | < 20ms | 结构化组织 | | **因果链提取** | < 10ms | 文本分析 | | **检索决策** | < 5ms | 决策逻辑 | | **质量评估** | < 10ms | 6维度评估 | | **状态一致性校验** | < 15ms | 多模块检查 | | **状态推理** | < 10ms | 规则推理 | | **跨会话关联** | < 20ms | 图谱查询 | | **遗忘分析** | < 10ms | 批量分析 | | 端到端同步路径 | < 200ms | 完整流程 | --- ## 十七、上下文类型扩展（混合方案）（新） ### 17.1 设计理念 本系统支持通过 **混合方案** 处理已知和未知类型的上下文信息： - **已知类型**：使用标准来源 + `subtype` 字段进行细粒度分类 - **未知类型**：使用 `CUSTOM` 来源 + `custom_type` 字段注册自定义类型 ### 17.2 标准上下文来源（9 种） | 来源 | 说明 | 默认优先级 | |------|------|-----------| | **SYSTEM** | 系统指令 | CRITICAL | | **USER_INPUT** | 用户输入 | CRITICAL | | **SHORT_TERM_MEMORY** | 短期记忆 | HIGH | | **LONG_TERM_MEMORY** | 长期记忆 | HIGH | | **RETRIEVAL** | 检索结果 | MEDIUM | | **TOOL_RESULT** | 工具返回 | LOW | | **INSIGHT** | 洞察建议 | OPTIONAL | | **REFLECTION** | 反思信息 | OPTIONAL | | **CUSTOM** | 自定义来源 | MEDIUM | ### 17.3 Metadata 规范 ```python metadata = { # 细粒度类型（可选） "subtype": str, # 如 "tool_prompt", "system_prompt" # 自定义类型（仅 CUSTOM 来源必需） "custom_type": str, # 如 "workflow_step", "ui_component" # 可选字段 "version": str, # 版本信息 "timestamp": str, # ISO 8601 格式时间戳 "source_id": str, # 来源标识 "weight": float, # 自定义权重（0.0 - 1.0） # 扩展字段 "extra": dict, # 额外的自定义数据 } ``` ### 17.4 混合方案架构 ``` 上下文输入 │ ├─→ 已知类型检测 │ │ │ ├─→ 标准来源 + subtype │ └─→ PriorityResolver 解析 │ └─→ 未知类型处理 │ ├─→ CUSTOM 来源 + custom_type ├─→ 注册自定义类型（register_custom_type） └─→ CustomTypeLifecycleManager 管理 ``` ### 17.5 自定义类型生命周期 1. **注册**：`orchestrator.register_custom_type(custom_type, priority, required_fields)` 2. **使用**：创建 `ContextBlock` 时使用 `custom_type` 3. **追踪**：`orchestrator.track_custom_type_usage(custom_type, usage_info)` 4. **废弃**：`orchestrator.deprecate_custom_type(custom_type, reason)` 5. **清理**：`orchestrator.cleanup_unused_types(threshold_days)` ### 17.6 优势 - **灵活性**：支持无限自定义类型，不限于预定义的 8 种标准来源 - **向后兼容**：标准来源继续使用，不受影响 - **类型安全**：自定义类型需要注册，系统会验证必需字段 - **生命周期管理**：追踪使用情况，支持废弃和清理未使用的类型 详见 [context_compaction_rules.md](context_compaction_rules.md) 了解更多细节。 --- ## 十八、上下文压缩架构（新） ### 18.1 压缩能力概览 本系统提供完整的上下文压缩能力，支持手动压缩和自动压缩两种模式。 ### 18.2 压缩策略（5 种） | 策略 | 说明 | 适用场景 | |------|------|----------| | `priority_based` | 基于优先级的压缩 | 保留高优先级内容 | | `relevance_based` | 基于相关性的压缩 | 保留高相关性内容 | | `freshness_based` | 基于新鲜度的压缩 | 保留最新内容 | | `composite` | 综合评分（优先级+相关性+新鲜度） | 平衡压缩 | | `rule_based` | 基于规则的压缩 | 遵循自定义规则 | ### 18.3 基于规则的压缩优先级 | 规则 | 权重 | 说明 | |------|------|------| | SYSTEM 来源 | +100 | 系统指令最高优先级 | | USER_INPUT 来源 | +90 | 用户输入高优先级 | | CRITICAL 优先级 | +80 | 关键内容高优先级 | | HIGH 优先级 | +70 | 高优先级内容 | | subtype = system_prompt | +50 | 系统提示词 | | 包含 causal_chain | +30 ~ +80 | 因果链（基础 +30，长度权重 +5/节点，最多 +50） | | 包含 custom_type | +30 | 自定义类型 | | 包含 version | +10 | 版本信息 | ### 18.4 因果链增强压缩 因果链包含关键的逻辑推导，压缩时会优先保留包含因果链的上下文块。因果链越长，权重越高。 **权重计算公式**： ``` causal_chain_weight = 30 + (节点数 × 5) 最大权重：+80（10 个节点时） ``` ### 18.5 压缩参数 | 参数 | 说明 | 默认值 | |------|------|--------| | `compression_ratio` | 压缩比率（保留的 token 比例，0.0 - 1.0） | 0.7 | | `min_blocks` | 最小保留块数 | 1 | | `target_tokens` | 目标 token 数（优先级高于 compression_ratio） | None | | `strategy` | 压缩策略 | priority_based | ### 18.6 自动压缩机制 当启用自动压缩时，系统会在 token 预算不足时自动触发压缩： ```python orchestrator.enable_context_compression( enable_auto_compress=True, auto_compress_threshold=0.8, # 使用率 > 80% 时触发 ) ``` ### 18.7 压缩质量保证 - **最小块数限制**：保证至少保留 `min_blocks` 个块，避免过度压缩 - **质量评分**：压缩后会生成质量评分（0-100），评估信息保留情况 - **因果链保护**：优先保留包含因果链的上下文块 详见 [context_compaction_rules.md](context_compaction_rules.md) 了解详细的压缩规则和最佳实践。 --- ## 附录 ### A. 模块映射表 详见 [module_index.md](module_index.md) ### B. 双轨架构详细文档 详见 [dual_track_architecture_overview.md](dual_track_architecture_overview.md) ### C. API参考文档 详见 [api_reference.md](api_reference.md) ### D. 认知模型层详细文档 详见 [cognitive_model_layer_overview.md](cognitive_model_layer_overview.md) ### E. 敏感信息类型（详细） | 类型 | 描述 | 过滤动作 | |------|------|----------| | **API_KEY** | API密钥 | REDACT（替换为[REDACTED]） | | **PASSWORD** | 密码 | MASK（部分掩码） | | **TOKEN** | 访问令牌 | REDACT | | **CREDIT_CARD** | 信用卡号 | MASK | | **EMAIL** | 电子邮箱 | REDACT | | **PHONE** | 电话号码 | REDACT | | **IP_ADDRESS** | IP地址 | MASK | | **PERSONAL_ID** | 身份证号 | MASK | ## 相关文档 - [memory_types.md](memory_types.md) - 记忆类型详解 - [activation_mechanism.md](activation_mechanism.md) - 激活器机制 - [insight_design.md](insight_design.md) - 洞察模块设计 - [short_term_insight_guide.md](short_term_insight_guide.md) - 短期记忆洞察指南 - [agent_loops_integration.md](agent_loops_integration.md) - Agent Loop 集成指南 - [agent_loops_advanced.md](agent_loops_advanced.md) - Agent Loop 架构演进 - [chain_reasoning_guide.md](chain_reasoning_guide.md) - 链式推理增强模块 ---