记忆系统 — 双轨持久化记忆

概述

本项目实现了双轨记忆系统，将 Trae 原生的核心记忆与 MCP Memory Server 提供的持久化知识图谱相结合。

系统的工作方式如下：

本系统的路由规则定义了 Step 0（记忆优先预检） 作为所有任务的通用入口：优先查询 MCP 记忆（权威源，知识图谱），获取项目/模式/用户上下文。如果记忆不足以完成任务，再回退到全量文件扫描。Core Memory（Trae 原生，会话级缓存）在 MCP 不可用时作为降级备用。

双轨写入：核心记忆处理自动的会话级写入，而 MCP 记忆通过 memory-kernel skill 显式写入，保存需要跨会话持久化的信息。

架构

规则层

skill-routing-and-execution-path.md 规则定义了 Step 0（记忆优先预检） 作为所有任务的通用入口：

同时，以下特定场景也路由到记忆系统：

技能层

工具层（MCP）

MCP Memory Server 提供以下工具：

使用方法

写入协议

只持久化跨会话有用的信息：

1. 搜索已有实体（mcp_memory_search_nodes）
2. 创建新实体（mcp_memory_create_entities）
3. 追加观察（mcp_memory_add_observations）
4. 关联实体（mcp_memory_create_relations）

实体命名：snake_case，项目相关实体以项目名称为前缀。

实体类型：

读取协议

作为 Step 0 通用预检的一部分，在任意任务开始时（而非仅"已知项目"）：

1. 通过 mcp_memory_search_nodes 搜索相关关键词（项目名、领域关键词、实体类型）
2. 通过 mcp_memory_open_nodes 打开匹配的节点获取完整观察
3. 判定上下文是否充足：
   • 充足：跳过项目级全量文件扫描，只读 1-2 个关键文件验证版本变更
   • 不足或为空：正常执行任务（触发 T-Shirt 分档和文件扫描），结束后写入新发现
4. MCP 工具不可用时静默降级，不阻塞执行

更新协议

当记忆中的信息已过时：

1. 通过 mcp_memory_delete_observations 移除过时观察
2. 通过 mcp_memory_add_observations 添加修正后的观察
3. 除非整个节点无效，否则不要删除并重建实体

初始化

配置 MCP Server

在 Trae 设置 → MCP Servers 中添加：

{
  "mcpServers": {
    "memory": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "D:/AppData/Memory/memory.jsonl"
      }
    }
  }
}

播种知识图谱

memory-kernel 技能支持初始播种。推荐为每个项目创建以下实体：

• 项目实体：名称、描述、技术栈、架构、约定
• 画像实体：用户身份与偏好
• 模式实体：可复用的解决方案和架构决策
• 已知解决方案实体：重复出现的问题-解决对

验证

打开一个新会话，询问项目相关问题。系统应从 MCP 记忆获取上下文，而非从头扫描整个项目。

冲突处理与降级

集成关系

• memory-kernel：对 MCP 记忆进行读写的主要执行技能
• self-improvement：从 self-improvement 沉淀的持久经验也应写入 MCP 记忆
• discovering-subagent-capabilities：相邻——记忆工具是平台级能力，非子 agent 级

与现有模式的关系

双轨记忆系统扩展了现有的 Memory-Intent-Trigger 架构：