大哥的记忆系统

🧠 三层记忆架构,告别Session失忆

自研本地化三层记忆架构,永久/今日/临时记忆分级存储,解决Session重启上下文丢失问题,完全可控零成本

收藏
9.1k
安装
2.8k
版本
1.0.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

核心用法

大哥记忆系统采用三层架构解决AI对话Session重启后的"失忆"问题:

  • L1永久记忆:存储身份偏好、技术栈、关键决策等核心信息,文件化持久保存
  • L2今日记忆:按日组织的Session记录,支持工作状态快速恢复
  • L3临时记忆:当前Session的实时上下文,Session结束时自动压缩归档

恢复流程标准化:memory-recovery.sh脚本自动读取各层记忆文件,通过关键词搜索定位关联信息,重建对话上下文。

显著优点

1. 完全本地化:纯文件系统实现,无外部API依赖,零运行成本
2. 可解释性强:Markdown明文存储,人工可读可审计,无黑盒

3. 分层设计合理:永久/今日/临时三级粒度,避免信息过载或丢失

4. 自动化程度高:Session结束Hook自动保存,压缩前高亮关键信息

5. 混合扩展性:文件架构预留与向量数据库(如Qdrant)的对接空间

潜在局限

  • 语义搜索弱于向量系统:依赖关键词匹配,复杂语义关联需人工维护
  • 规模天花板:纯文件系统在大规模记忆(万级条目)时检索效率下降
  • 无自动实体提取:需人工判断并记录"关键决策",存在遗漏风险
  • 单点存储风险:未内建分布式备份机制,文件损坏即丢失
  • 迁移成本:记忆深度绑定特定工作目录结构,跨环境迁移需手动适配

适合人群

  • 高频使用长Session对话的开发者/研究者
  • 对数据隐私敏感、拒绝云化方案的用户
  • 技术栈稳定、需要持续累积领域知识的场景
  • 有基础脚本能力、能维护文件系统的用户

常规风险

| 风险场景 | 等级 | 说明 |
|---------|------|------|
| 工作目录误删 | 高 | 永久记忆文件丢失需从备份重建 |
| Session异常中断 | 中 | 临时记忆未保存,丢失本轮进度 |
| 关键决策漏记 | 中 | 人工判断偏差导致重要信息未归档 |
| 记忆膨胀 | 低 | 长期运行后检索噪音增加,需月度清理 |

安全解读

核心用法

memory-system 是一套面向AI对话场景的三层记忆恢复系统,通过结构化文件管理解决Session重启导致的"失忆"问题。用户执行 bash /data/workspace/scripts/memory-recovery.sh 即可按顺序恢复永久记忆(身份/技术栈/关键决策)、今日记忆(当日工作日志)和临时记忆(Session上下文)。系统支持自动保存机制,包括Session结束Hook、压缩前高亮保存和关键决策自动记录。

显著优点

完全本地可控:纯shell脚本实现(52行),零外部依赖,无网络通信,避免API成本和服务中断风险。

架构清晰:L1永久记忆(跨Session持久)、L2今日记忆(按日组织)、L3临时记忆(自动清理)三层分离,检索路径明确。

可解释性强:Markdown文件直接可读,记忆内容完全透明,便于人工审计和调试。

隐私合规:所有数据本地处理,不涉及第三方共享,符合GDPR数据最小化原则。

潜在局限性

搜索能力弱:依赖文件名和简单关键词匹配,无语义搜索能力,海量记忆时检索效率受限。

无自动实体提取:需人工判断"什么值得记录",依赖用户自律性,易出现记录遗漏或冗余。

单用户设计:未考虑多用户隔离或协作场景,记忆文件无访问控制机制。

缺乏版本管理:记忆文件覆盖更新,误删或错误记录难以回溯恢复。

适合人群

  • 高频使用AI编程助手、需要跨Session保持上下文的开发者
  • 对数据隐私敏感、拒绝云端记忆服务的用户
  • 偏好简洁透明工具、愿意手动维护记忆结构的极客用户
  • 工作流相对固定、技术栈变化缓慢的专业人士

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 路径遍历 | 低 | 脚本使用date命令生成固定格式日期,当前无注入风险,但建议未来添加路径规范化 |
| 数据丢失 | 中 | 依赖本地文件持久化,无自动备份机制,磁盘故障或误删将导致记忆永久丢失 |
| 记忆膨胀 | 中 | 缺乏自动归档策略,长期运行后永久记忆可能累积冗余信息,需每月手动清理 |
| 恢复失效 | 低 | 若记忆文件格式被意外破坏,可能导致恢复流程报错,需保持文件格式规范 |

与向量记忆系统对比建议

短期(<6个月)或记忆量<1000条时,本系统性价比更优;长期可考虑混合方案——本地文件存储+周期性向量化索引。

大哥的记忆系统 内容

scripts文件夹
手动下载zip · 3.4 kB
memory-recovery.shtext/x-shellscript
请选择文件