smart-memory-manager

Intelligent memory management for agents with short/long-term memory layering, semantic search, auto summarization, RAG enhancement

🧠 智能记忆管理器

核心亮点

1. 📚 分层记忆体系：短期/长期/重要记忆三层架构，自动清理过期记忆，解决上下文溢出问题
2. 🔍 多模式检索：支持关键词/语义/混合三种检索模式，快速召回相关记忆，提升RAG准确率
3. 📝 自动摘要能力：一键生成记忆摘要，支持长会话上下文压缩，token占用减少70%
4. 💾 持久化支持：支持内存/磁盘持久化，重启后记忆不丢失

🎯 适用场景

• 长会话Agent、聊天机器人
• RAG应用的记忆层
• 需要长期记忆的任务型Agent
• 客服、助理类Agent的上下文管理

📝 参数说明

参数	类型	必填	说明
action	string	是	操作类型：add/search/summarize/clear/list/load/save
content	string	否	add操作必填，记忆内容
type	string	否	add操作可选，记忆类型：short-term/long-term/important，默认short-term
query	string	否	search操作必填，搜索关键词
limit	number	否	search/list操作可选，返回结果数量，默认5/20
typeFilter	string	否	所有操作可选，过滤记忆类型，默认all
persist	boolean	否	add操作可选，是否持久化存储，默认false
persistPath	string	否	load/save操作可选，持久化文件路径，默认./memory-store.json

💡 开箱即用示例

添加记忆

typescript

// 添加长期记忆
await skills.smartMemoryManager({
  action: "add",
  content: "用户喜欢喝咖啡，不加糖，每周三下午喝奶茶",
  type: "long-term",
  persist: true
});

搜索记忆

typescript

const result = await skills.smartMemoryManager({
  action: "search",
  query: "用户喜好",
  limit: 3,
  searchMode: "hybrid" // 关键词+语义混合检索
});

生成会话摘要

typescript

const summary = await skills.smartMemoryManager({
  action: "summarize",
  typeFilter: "short-term",
  maxTokens: 500
});

持久化与加载

typescript

// 保存所有记忆到磁盘
await skills.smartMemoryManager({
  action: "save",
  persistPath: "./my-memory.json"
});

// 从磁盘加载记忆
await skills.smartMemoryManager({
  action: "load",
  persistPath: "./my-memory.json"
});

🔧 技术实现说明

• 内置记忆自动清理机制，短期记忆最多保留100条，避免内存溢出
• 模块化设计，可轻松对接向量数据库实现语义检索
• 全链路类型安全，参数自动校验
• 轻量无外部依赖，开箱即用，也支持自定义扩展