Fluid Memory

🧠 会遗忘、懂强化的赛博大脑

基于流体认知架构的智能记忆系统,会遗忘、需强化、懂语义,支持自动Hook同步,打造真正「活着」的赛博大脑。

收藏
20.3k
安装
5.6k
版本
1.0.2
CLS 安全性认证2026-07-07
点击查看完整报告 >

使用说明

核心用法

Fluid Memory 是一套模拟人类认知规律的记忆管理系统,通过「植入-唤起-遗忘」三位一体机制实现动态知识管理。系统提供六种核心工具:

  • fluid_remember: 主动写入新记忆(触发词:「记住」「植入」「记录」)
  • fluid_recall: 语义检索并自动强化记忆权重(触发词:「还记得」「我之前」)
  • fluid_forget: 归档指定记忆(触发词:「忘记」「不要再提」)
  • fluid_status: 查看大脑运行状态
  • fluid_summarize: 多轮对话后批量总结
  • fluid_increment_summarize: 增量式对话总结(Token 优化方案)

自动学习模式是最大亮点:通过 fluid-memory-sync Hook 监听 message:sent 事件,无需用户频繁说「记住xxx」,系统在后台静默累积对话上下文。支持通过 config.yaml 关闭。

显著优点

1. 仿生遗忘机制: 动态遗忘(检索分<0.05自动过滤)+ 主动遗忘 + 梦境守护(定时归档<0.15),避免信息膨胀
2. 强化学习特性: 每次 recall 自动增加访问计数,高频知识自然沉淀

3. 语义理解: 非关键词匹配,支持自然语言查询

4. Hook 自动化: 零感知持续学习,减少用户操作负担

5. 增量总结: 对比批量总结节省 Token,适合长对话场景

潜在缺点与局限性

1. 分数阈值黑盒: 0.05/0.15 等遗忘阈值不可配置,用户无法自定义「记忆保鲜期」
2. Hook 依赖风险: 若 fluid-memory-sync Hook 未正确注册或冲突,自动学习失效且静默失败

3. 本地化架构: 依赖本地 Conda 环境和 Python wrapper,跨平台部署复杂

4. 无记忆冲突解决: 相同主题的新旧记忆共存,缺乏自动去重或版本管理机制

5. 「梦境守护」未说明周期: 定时任务的频率和触发条件不透明

适合人群

  • 需要 AI 长期记忆个人偏好、项目背景的深度用户
  • 厌倦了「每轮重复上下文」的 Token 敏感型开发者
  • 追求「越聊越懂我」的个性化体验爱好者
  • 愿意维护本地 Python 环境的技术用户

常规风险

  • 记忆漂移: 自动总结可能丢失关键细节或产生歧义
  • 隐私泄露: 本地存储虽无云端风险,但明文 wrapper 调用可能暴露于日志
  • 召回率不确定: 语义检索的「懂」是概率性的,重要信息建议主动 remember 固化
  • 配置误操作: auto_learn: false 或 Hook 失效会导致长期记忆断层,用户难以察觉

安全解读

核心用法

Fluid Memory 是一款基于 ChromaDB 向量数据库的本地记忆系统,为 AI 助手提供类人类的记忆能力。系统通过三个核心动作与用户交互:

  • 植入 (fluid_remember):将用户明确要求记住的内容写入记忆库
  • 唤起 (fluid_recall):根据语义查询检索相关记忆,每次检索自动强化该记忆权重
  • 遗忘 (fluid_forget):主动归档不再需要的记忆

支持两种学习模式:用户主动触发,或通过 Hook 实现自动学习——每次对话后自动增量总结并存储。系统具备独特的"遗忘机制":低相关性记忆在检索时被过滤,极低权重记忆由"梦境守护"进程定时归档。

显著优点

1. 真正的语义理解:基于向量相似度而非关键词匹配,能理解同义改写和上下文关联
2. 人脑式记忆管理:自动强化常用知识、淡化冷门信息,避免记忆库膨胀

3. 完全本地运行:ChromaDB 存储于本地目录,零外部 API 调用,无数据外泄通道

4. 低运营成本:无第三方订阅费用,增量总结机制节省 Token 消耗

5. 透明可控:auto_learn 可关闭,记忆可主动删除,符合隐私自主原则

潜在缺点与局限性

  • 硬编码路径问题:wrapper.py 中存在 Windows 特定路径,Linux/macOS 需手动调整
  • 依赖本地 Python 环境:需要 Conda/Miniconda 配置,增加部署复杂度
  • 隐私告知不足:自动收集功能默认开启,文档未充分强调需用户知情同意
  • 无加密存储:本地数据以明文形式保存,设备共享场景存在泄露风险
  • 社区维护风险:个人开发者维护,长期更新稳定性存疑

适合人群

  • 注重隐私、拒绝云端记忆服务的用户
  • 需要 AI 记住长期偏好和上下文的深度使用者
  • 具备基础技术能力、能处理本地环境配置的开发者

常规风险

1. 数据丢失:本地存储无云端备份,磁盘损坏可能导致记忆永久丢失
2. 跨设备同步缺失:纯本地架构无法自动同步多台设备记忆

3. 误删除不可逆:归档操作后无恢复机制,重要记忆需谨慎操作

4. 存储膨胀:高频对话场景下向量数据库可能占用较大磁盘空间

安全合规要点

  • 符合 GDPR 数据最小化原则
  • 通过 CLS-Certify 静态/动态分析,无恶意代码
  • 建议用户主动配置 auto_learn: false 并了解数据收集范围

Fluid Memory 内容

hooks文件夹
fluid-memory-sync文件夹
手动下载zip · 14.7 kB
handler.jstext/javascript
请选择文件