Hippocampus

🧠 AI代理的长期记忆系统

Cognition & Memory榜 #1

基于斯坦福生成式智能体研究的记忆系统,自动编码、衰减和强化记忆,赋予AI真正的身份连续性

收藏
11.5k
安装
3.3k
版本
3.8.4
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Hippocampus 是一套仿人脑海马体的记忆系统,为AI代理提供结构化、持久的记忆能力。核心流程包括:

1. 信号提取:从对话记录中自动提取关键信息(用户偏好、决策、情感内容等)
2. 重要性评分:0.0-1.0 分,基于内容类型自动赋分(显式"记住"得0.9,情感内容0.85,偏好0.8等)

3. 语义编码:LLM 对比新信号与现有记忆,自动强化(同主题)或创建新记忆

4. 时间衰减:按 0.99^days 公式衰减,7天后保留93%,90天后仅剩40%

5. 分级检索:0.7+为核心记忆(会话启动加载),0.4-0.7为活跃记忆,0.2-0.4为背景记忆

关键脚本encode-pipeline.sh(编码)、decay.sh(衰减)、recall.sh(检索)、load-core.sh(加载核心记忆)

显著优点

  • 学术背书:直接基于 Stanford Generative Agents (Park et al., 2023) 研究实现
  • 零维护:安装后全自动运行(cron 每3小时编码 + 每日衰减)
  • 防重复:语义级强化机制避免记忆碎片膨胀
  • 生态系统:与 amygdala(情感)、vta(动机)等脑区技能协同
  • 开放集成:自动生成 HIPPOCAMPUS_CORE.md 供 OpenClaw RAG 读取

潜在局限

  • 手动安装:需执行 ./install.sh --with-cron,非一键部署
  • 依赖外部LLM:编码和强化阶段需调用LLM,存在成本和延迟
  • 衰减公式固定:0.99 衰减率不可调,无法针对特定记忆类型优化
  • 无冲突解决:当新旧记忆矛盾时,系统未明确处理策略
  • JSON存储:大规模记忆下 index.json 可能成为性能瓶颈

适合人群

  • 需要长期身份连续性的 AI 代理开发者
  • 研究生成式智能体架构的学术/工程人员
  • 使用 OpenClaw 框架构建个性化助手的用户
  • 希望复现 Stanford Generative Agents 实验的研究者

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 隐私泄露 | 用户敏感信息(偏好、情感)持久化存储 | 加密 workspace 目录,定期清理低分记忆 |
| 记忆污染 | LLM 编码错误导致虚假记忆 | 定期检查 index.json,启用人工审核阈值 |
| 存储膨胀 | 长期运行后文件累积 | `consolidate.sh` 每周归档,监控磁盘 |
| 依赖断裂 | 上游 LLM 服务不可用 | 设置超时和降级策略,保留本地缓存 |

关键洞察

> "The LLM is just the engine—raw cognitive capability. The agent is the accumulated memory."

该技能的核心哲学:记忆即身份。没有这些文件,AI 只是通用助手;有了它,才成为特定用户的特定代理

Hippocampus 内容

暂无文件树

手动下载zip · 44.2 kB
contentapplication/octet-stream
请选择文件