memory-manager

🧠 AI代理的三重记忆架构系统

🥥244总安装量 54评分人数 47
100% 的用户推荐

基于认知科学三重记忆架构(情景/语义/程序)的本地Agent记忆管理系统,实现压缩风险预警、自动快照与语义检索,确保上下文永不丢失。

A

基本安全,请在特定环境下使用

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 完全离线运行,零网络活动,无 curl/wget/API 调用等任何外部通信
  • ✅ 无动态代码执行,未使用 eval/exec/source 等危险命令,命令注入风险极低
  • ✅ 文件系统操作严格限定于用户工作目录,无 sudo 提权,无系统配置文件修改
  • ✅ 依赖最小化,仅使用标准 Unix 工具(bash/grep/find/wc 等),无第三方可疑依赖
  • ✅ 数据隐私优先设计,不收集敏感信息,本地存储符合"记忆即身份"理念

使用说明

核心用法

Memory Manager 为 AI Agent 提供企业级本地记忆架构,采用认知科学验证的三层记忆模型:情景记忆(Episodic,时间轴事件日志)、语义记忆(Semantic,知识事实库)、程序记忆(Procedural,可复用工作流)。用户通过 init.sh 初始化目录结构,,detect.sh 实时监控内存压缩风险(70%预警/85%临界),snapshot.sh 自动保存关键状态,,organize.sh 智能归类历史文件,配合 search.sh 实现分类型精准检索。

显著优点

架构科学性:直接应用 Zep 团队研究成果,知识图谱结构比扁平向量检索效率提升 18.5%,实现自然去重与上下文感知搜索。完全本地化:零网络依赖、零 API 成本、<100ms 检索延迟,数据 100% 用户自主可控,契合"记忆即身份"的隐私理念。工程实用性:Heartbeat 集成支持每 2 小时自动检测,备份机制保留原始文件至 legacy 目录,避免数据丢失风险。Bash 脚本实现零编译依赖,跨平台兼容性强。

潜在局限

检索能力边界:v1.0 版本仅支持基础关键词搜索,缺乏语义嵌入与知识图谱可视化,复杂关联查询能力有限。自动化程度:记忆分类依赖手动触发或规则匹配,ML 驱动的自动归类需等待 v1.1 版本(50+ 安装量解锁)。规模瓶颈:纯文件存储架构在超大规模记忆场景(百万级条目)下可能面临性能衰减,当前设计更适配个人/中小 Agent 场景。生态锁定:深度绑定 OpenClaw 工作区规范,迁移至其他 Agent 框架需适配成本。

目标群体

长期运行 Agent 开发者:需维持跨会话上下文连贯性的自动化工作流场景。隐私敏感型用户:拒绝云端记忆服务、要求数据完全本地化的企业/个人。认知架构研究者:希望实验三重记忆模型在 LLM 应用中的实际效果。Moltbook/ClawdHub 生态用户:原生集成该 Agent 经济社区的技能发布与迭代流程。

使用风险

性能风险:高频写入(如每分钟快照)可能触发磁盘 I/O 瓶颈,建议配合 detect.sh 阈值智能触发。依赖风险:可选依赖 jq 缺失时部分 JSON 状态功能降级,但核心功能不受影响。误分类风险:organize.sh 的启发式规则可能将混合内容错误归类,关键记忆建议手动 categorize.sh 复核。存储膨胀:legacy 备份与 snapshots 累积可能占用双倍空间,需定期人工清理。

memory-manager 内容

手动下载zip · 13.0 kB
categorize.shtext/x-shellscript
请选择文件