hippocampus_22

hippocampus_22

陪伴型机器人的情感记忆层 —— 让她记得、会忘，还敢说"我记不太清了"。

不是把聊天存进数据库，是照着人脑海马体的五个环节做记忆：**事件编码 → 巩固 → 遗忘 →

联想召回 → 元记忆**。一个本地 SQLite 文件就是全部记忆，不上传、不联网、不用向量库。

> 本项目派生自 [dsh-hippocampus](https://github.com/kianajunjie/dsh-hippocampus) v0.3.1（MIT），

> 在保留记忆内核的基础上继续演进；派生与署名说明见 [NOTICE](NOTICE)。

---

快速开始

不需要 API Key，先看效果：

git clone https://github.com/kianajunjie/hippocampus_22.git
cd hippocampus_22
node cli.mjs demo

demo 会塞几条带情绪的旧事件，跑一次遗忘，再召回一次，直接看到"情绪权重让旧记忆活得更久"。

作为库：

npm i hippocampus-22

import { createHippocampus } from 'hippocampus-22'

const hip = await createHippocampus({ apiKey: process.env.DEEPSEEK_API_KEY })

// 每条消息进来都走一遍：认人 → 组装提示词块 → 召回
const r = await hip.handleTurn({ channel: 'qq', externalId: msg.user_id, text, reply })
// r.context 塞进系统提示，r.recall 是召回结果

// 每天一次巩固：合并近重复、按情绪衰减、写一句印象
await hip.replay()

作为 HTTP 服务（任何语言都能接）：

import { createMemoryServer } from 'hippocampus-22/http'
await createMemoryServer({ hip, port: 7717, token: 'secret' })

curl -s localhost:7717/context -H 'authorization: Bearer secret' \
  -H 'content-type: application/json' \
  -d '{"channel":"telegram","externalId":"42","text":"我腿疼"}'

作为 DSH 插件（im / 网页）：

dsh plugin --profile web add github:kianajunjie/hippocampus_22

---

核心能力

| 能力 | 说明 |

| --- | --- |

| 事件记忆 | 每轮对话变成「谁、何时、发生了什么、什么情绪」 |

| 情绪加权遗忘 | 被凶/被感动的那天能撑几个月，普通的一天很快淡掉 |

| 确定度 | 每条记忆带「记得清 / 大概记得 / 只记得有这回事」，她不会装确定 |

| 改口即失效 | 你改主意了（住成都 → 住杭州），旧事实自动作废，不自相矛盾 |

| 关系层 | 跟每个人的亲密、信任、没解开的疙瘩，久不出现会淡，原谅了才解开 |

| 事实 / 章节 / 技能 / 缺口 | 住哪、哪阵子、怎么做事、什么不懂（不懂就主动问） |

| 按人隔离 | A 看不到 B 的记忆，群聊看不到私聊 |

| 零依赖 | 只用 Node 内置 SQLite（node:sqlite），不装任何第三方包 |

命令一览

hippo encode --turns    # 把对话批量编码成事件