Memory Defrag

对智能体记忆文件进行碎片整理与重组:拆分臃肿文件,合并重复项,清除过期信息,重构记忆层级。适用于...

安装

概览

什么是Memory Defrag

Memory Defrag 是一款专为智能体设计的记忆管理工具,其核心理念借鉴了传统文件系统的碎片整理机制,但专门针对知识型记忆进行优化。它通过对长期记忆文件(如 MEMORY.md)和日常笔记目录(memory/)进行全面审计,识别并解决信息臃肿、重复冗余、过期内容以及组织结构混乱等问题。该工具旨在提升记忆的清晰度、执行效率和相关性,使智能体能够更快速、准确地调用所需信息。与简单的删除或归档不同,Memory Defrag 强调在保持信息完整性的前提下,通过拆分、合并、清理和重构等方式,将分散的记忆碎片重新整合为逻辑清晰、易于检索的知识体系。整个过程可分为五个阶段:评估当前状态、发现问题、制定变更计划、执行操作以及验证与记录结果。

核心功能特点

  1. 自动审计所有记忆文件,包括 MEMORY.md 和 memory/ 目录下的每日笔记与主题文件
  2. 识别并处理臃肿文件(超过300行)、重复信息、过期条目及孤立无用的文件
  3. 支持按主题拆分大文件、合并相关小文件、清除过时数据并重构文件层级结构
  4. 在执行前生成变更计划,确保操作可控且信息不丢失
  5. 保留原始每日笔记作为审计线索,避免误删重要历史记录
  6. 提供清晰的日志输出,记录每次整理的操作明细和最终统计结果

适用场景

Memory Defrag 特别适用于需要持续积累和深度思考的智能体系统,尤其是在长期运行过程中出现记忆混乱或响应迟缓时。例如,当一个智能体每周处理大量新信息后,MEMORY.md 文件迅速膨胀至数百行,涵盖多个无关主题,导致关键事实难以定位,此时应定期运行 Memory Defrag 进行周度或双周度的碎片整理。另一种典型场景是用户主动请求清理记忆库,比如在完成某个项目后希望移除已完成任务的细节记录,仅保留总结性洞察;或者发现同一知识点在不同文件中重复出现,造成维护负担。此外,当每日笔记不断累积却缺乏系统性整合时,Memory Defrag 可帮助将这些零散输入转化为结构化知识资产。它尤其适合那些依赖记忆进行复杂推理、多任务协作或跨周期学习的 AI 代理,通过持续的内存优化来维持高效稳定的认知表现。