
RememberMe
io.github.SoHardToMakeAName/RememberMe
长期记忆 MCP server:记住用户是谁、经历过什么、情绪模式如何,跨会话不丢。
Documentation
RememberMe
RememberMe MCP 已经上线 —— 详见 MCP Server(记忆后端形态) 一节。
一个真的记得你的 AI 陪伴。换模型、换平台、关掉再开,它依然知道你是谁、你喜欢什么、你经历过什么。
这是什么
它会记住你。
不是那种"看起来记得"的客气话——是真的把"你是谁、你喜欢什么、你经历过什么"作为本地数据沉淀下来。半年后你重新打开,问一句"还记得我吗",它能从上次聊到一半的话题继续说下去。
不是聊天客服那种"每次重头开始"的体验。RememberMe 的核心承诺是:让它积累的所有认知跨越会话、跨端、跨模型持续存在。
- 记得你是谁 —— 你的名字、职业、生活阶段、所在地、关注议题
- 记得你喜欢什么 —— 偏好从你的真实反馈里长出来,不预设"用户喜欢简洁回复"这种开发者偏见
- 记得你经历过什么 —— 反复出现的情绪模式被命名和保留("work-burnout"、"life-aversion" 这种),不只是流水账
- 记得你们聊过什么 —— 半年后回来重开,对话上下文还在
提供 网页界面(默认)、CLI 界面,以及 MCP Server —— 让 Claude Code、Claude Desktop、Cursor 这些别的 AI 直接用上你的长期记忆。 目前网页界面还不是很完善
本项目由vibe coding生成
🧠 它怎么记住你
严格说 RememberMe 是一个上下文编排器 —— 把你的画像、记忆、情绪模式、对话历史整合成更适合当前这一刻的 system prompt,让同一个 LLM 在你这里表现得比在通用聊天窗口里更懂你。
你的画像存在本地 markdown 文件里
- 你是谁(基本信息)—— 昵称、职业、所在地等,作为
data/profile/PROFILE.md的字段 - 你喜欢什么(偏好 + 沟通风格)—— 从你的反馈学习里自然长出来,不是开发者预设的"长度/语气/深度/格式"固定维度
- 你经历过什么(事件 + 情绪模式)—— 反复出现的情绪反应被独立存储为
emotion类型记忆,带 ≥2 条证据才会被保留
每条都是纯文本文件,你能用任何编辑器打开看、改。
半年后回来,它还记得
- 上次聊到一半的话题
- 你的情绪模式("你每次提到工作都焦虑",而不是"你今天心情不好")
- 你的偏好(你说过"别回太长",它现在回得简短)
- 跨会话、跨端(CLI ↔ Web)、跨模型(Claude / DeepSeek / GPT-4)都共享同一份记忆
关于隐私:清楚两个边界
- ✅ 本地数据:你的画像、记忆、反思、反馈学习记录都只在
data/目录下,.gitignore已经覆盖,RememberMe 不主动上传到任何 RememberMe 控制的服务器 - ⚠️ LLM 调用:要工作就必须把对话内容发到你配置的 LLM provider(Anthropic / DeepSeek / OpenAI 等)。RememberMe 本身不存储这些对话之外的位置,但你信任你的 LLM provider 这一点是前提 —— 这是所有基于 LLM 的应用都共有的限制
🌐 网页版默认只监听本机
网页版默认绑定 127.0.0.1,同一个 WiFi / 局域网里的其他设备访问不到。
(早期版本不写 hostname,Bun 默认绑 0.0.0.0 —— 局域网可见,而 /api/send 会直接用你的 API key 调 LLM,等于把额度送人。v0.22.0 起默认已收紧。)
| 需求 | 怎么做 |
|---|---|
| 只在本机用(默认) | 什么都不用设 |
| 要在局域网的其他设备上用 | HOST=0.0.0.0 EC_WEB_TOKEN=你的令牌 bun run start |
| 确实要裸奔(不建议) | HOST=0.0.0.0 EC_WEB_ALLOW_UNAUTHENTICATED=1 bun run start |
- 设了
EC_WEB_TOKEN后,所有/api/*都要求Authorization: Bearer <token>;浏览器第一次访问会弹窗要一次令牌,之后存在localStorage - 对外监听却没有令牌 → 服务器拒绝启动(宁可起不来,也不默默把 key 送人)
- 所有
/api/*还会检查Origin,挡掉浏览器发起的跨站请求(CSRF)
核心特性
🧠 多层记忆
不只是"你说过什么",还区分"反复出现的情绪模式"和"影响你的生活事件"和"外部资源"。
emotion— 反复出现的情绪模式(需要 ≥2 次印证)event— 有情绪影响的生活事件reference— 外部资源(医生/咨询师/联系人)
👤 用户画像
自动累积 6 个维度的长期信息:基本资料、沟通风格、关注话题、偏好禁忌、情绪基线、近期变化。
🪞 每日反思
后台进程读你的情绪时间线、近期记忆、画像,归纳成"今日洞察"——越用越懂你。
🌊 大五人设(OCEAN)
不再有预定义人格。新会话启动时,你说一句话(如"苏格拉底"、"温柔大姐姐"、"嘴毒心善的朋友"),LLM 翻译成 5 维数值(开放性 / 尽责性 / 外向性 / 宜人性 / 神经质)+ 一段自由文本偏好。每个会话独立,存到 data/personality/{sessionId}.json。
🪄 自动学习你的偏好
你回复里给的反馈("别回太长""别用 emoji""叫我小李")会被自动分类为正面/负面/中性,提取成自然语言观察,累积到 data/learned-prefs/default.json。下一轮 system prompt 会带上这些观察作为软提示(不是硬规则)。
💬 按 session 管理对话
每个会话持久化到 data/sessions/,含人设 + 历史 + 标题。点左侧列表切换。
📝 纯 Markdown 配置
画像、记忆、反思都是 .md 文件。没有 YAML,没有 JSON 配置(除了运行时数据)。
🌐 网页界面(默认)
默认启动 Bun.serve() HTTP 服务器。打开 http://localhost:3000 即可。SSE 流式 + 实时状态栏。
🔌 MCP Server(记忆后端形态)
把同一套记忆系统打包成 MCP server,挂到任意 MCP 客户端上,让别的 AI 拥有你的长期记忆。
4 个工具:3 个读(list_memories / read_memory / read_profile)+ 1 个写(record_turn)。
细节见下方 MCP Server 一节。
快速开始
# 1. 安装依赖(需要 bun ≥ 1.1)
bun install
# 2. 配置 API key(任选一个,推荐 Anthropic)
export ANTHROPIC_API_KEY=sk-ant-xxx
# 或(OpenAI 兼容端点:DeepSeek/Moonshot/自建)
export OPENAI_API_KEY=sk-xxx
# 3. 启动(默认网页版)
bun run start # → http://localhost:3000
bun run repl # → CLI 模式
也可以把 API key 放进 settings.json(Anthropic SDK 格式):
{
"env": {
"ANTHROPIC_API_KEY": "sk-ant-your-key-here",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_MODEL": "deepseek-v4-flash"
}
}
首次启动会自动创建 data/profile/PROFILE.md 和 data/sessions/。直接开始对话即可。
怎么用
网页版(默认)
访问 http://localhost:3000:
- 左侧 sidebar:会话列表(+ 新对话按钮)、人设初始化入口、模型输入框、清空/导出按钮
- 右侧主区:聊天消息流 + 输入框
- Enter 发送,Shift+Enter 换行
- 状态栏实时显示:
思考中… (N 字, Ns)→就绪 (N s) - 新会话 + 人设初始化:点 "+ 新对话" → 弹窗 → 简单描述你想要的人格("苏格拉底")→ LLM 翻译成 OCEAN 数值 + 自由文本偏好 → 保存到
data/personality/{sessionId}.json - 切换会话:点左侧列表里的某条 → 立刻载入那条历史
- 切换模型:模型输入框填入新模型名 → 点"应用"
新会话启动时通过一句话描述生成 OCEAN 人设;不描述就用默认中性人设(OCEAN 全 0.5)。
CLI 模式
bun run repl
REPL 命令
| 命令 | 作用 |
|---|---|
| 直接输入 | 开始对话 |
/persona show | 显示当前 OCEAN 人设 + preferences |
/persona init <一句话描述> | 用 LLM 生成 OCEAN,写入当前 session(首次启动会提示) |
/persona describe <文本> | 不调 LLM,直接修改 preferences |
/persona reset | 重置人设为默认中性(OCEAN 全 0.5) |
/session list | 列出所有 session(按最近活跃倒序) |
/session current | 显示当前 session 详情(id + 标题 + 历史条数 + 人设) |
/session new [描述] | 新建 session(可选立刻 init 人设;CLI 与 web 共享同一份会话数据) |
/session switch <id> | 切换到指定 session(保存当前 → 加载目标 → 重载人设) |
/session save | 手动保存当前 session(退出时也会自动保存) |
/session delete <id> | 删除指定 session + 关联人设(不能删当前) |
/memory list / read <name> / types / save <type> <name> <desc> | 记忆管理(2 主类 + 1 辅类) |
/memory auto <on|off|status> | 自动抽取开关(默认开) |
/memory suggest | 手动触发抽取 |
/timeline / /timeline stats | 情绪轨迹 / 统计 |
/profile / /profile path / /profile scan / /profile reset | 用户画像管理 |
/learner / /learner reset | 人设学习器状态 |
/reflect [days] | 手动触发反思(默认:看最近 7 天) |
/reflections list / read <date> | 浏览反思历史 |
/stats | 会话统计(含 compact 建议) |
/compact | 手动 compact 历史 |
/quiet | 切换 [emotion: ...] 调试标签 |
/clear | 清空当前会话历史 |
/help | 完整帮助 |
/quit | 退出(自动保存当前 session) |
CLI 与网页端共享会话
data/sessions/ 是 CLI 和网页版共用的存储目录:
- 在 web 聊了一段 → 启动 CLI → CLI 自动加载最近一个有对话的 session
- 在 CLI 聊了一段 → 关掉 web → 重启 web → web 也加载同一段
- 切换会话用
/session switch <id>(CLI)或左侧 sidebar(web)
MCP Server(记忆后端形态)
把 RememberMe 挂到任意 MCP 客户端(Claude Code / Claude Desktop / Cursor / VS Code …)上, 让别的 AI 也拥有你的长期记忆。
提供 4 个工具:
| 工具 | 类型 | 作用 |
|---|---|---|
list_memories | 读 | 列出全部记忆(名称 + 描述 + 日期) |
read_memory | 读 | 取单条记忆全文 |
read_profile | 读 | 读用户画像 6 段 |
record_turn | 写 | 宿主说「这轮值得记」,记忆系统决定「记成什么」 |
设计:宿主模型只判断「值不值得记」,抽取和归纳由 RememberMe 服务端用原版 rubric 完成,
所以记忆的类型判断和归纳质量和网页版/CLI 完全一致(复用 extractMemoryCandidates())。
在本地 Claude Code 里使用(开发版)
# 1. 构建(改过 src/mcp/ 后要重新构建)
bun install
bun run build:mcp
# 2. 注册到 Claude Code(-s local = 只对当前项目生效,写进 ~/.claude.json)
# 把 <REPO> 换成你的仓库绝对路径
claude mcp add rememberme -s local \
-e REMEMBERME_DATA_DIR=<REPO>/data \
-- node <REPO>/dist/mcp/index.js
# 3. 验证
claude mcp list # 应该看到 rememberme ... ✔ Connected
然后重启 Claude Code(MCP 工具在会话启动时加载),工具会以
mcp__rememberme__list_memories 等形式出现。
想改成全局可用(所有项目都能用)就把 -s local 换成 -s user。
⚠️ 作用域决定你在哪些目录能用:
claude mcp list只显示当前目录所属项目的 local 条目 + 全局的 user 条目。 所以-s local的话,必须 cd 到仓库根目录里跑claude mcp list才看得到; 在别的目录跑会显示「No MCP servers configured」。 同名的 local 条目会遮蔽 user 条目 —— 排查时先确认自己看的是哪一个作用域。
REMEMBERME_DATA_DIR 必须给绝对路径。不设的话会落到
~/.rememberme/data, 读不到本仓库data/里的既有记忆。数据目录的解析优先级是REMEMBERME_DATA_DIR→settings.json的dataDir→~/.rememberme/data。也可以改用源码模式(改代码即时生效,不用重新构建):
claude mcp add rememberme-dev -s local \ -e REMEMBERME_DATA_DIR=<REPO>/data \ -- bun run <REPO>/src/mcp/index.ts
用 npx 装(发布后)
npm 包名是 @jokab1074/rememberme:
claude mcp add rememberme -s user -- npx -y @jokab1074/rememberme
发布后的包会带上 mcpName 字段(io.github.SoHardToMakeAName/RememberMe),
用于 MCP Registry 的归属校验;
仓库根目录的 server.json 就是登记用的清单。
首次使用需要配一次 API key。 MCP server 找配置的顺序是:
1. REMEMBERME_SETTINGS 环境变量
2. ~/.rememberme/settings.json
3. <包目录>/../settings.json
npm 安装版落在 node_modules/ 里,第 3 档找不到你仓库里的 settings.json,
所以只剩 ~/.rememberme/settings.json。建一个就行(格式见 settings.json.example):
{
"env": {
"ANTHROPIC_API_KEY": "sk-ant-你的key",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com",
"ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929"
}
}
或者直接指到已有的配置文件:
claude mcp add rememberme -s user \
-e REMEMBERME_SETTINGS=/path/to/settings.json \
-- npx -y @jokab1074/rememberme
没配 key 的话,三个读工具照常能用,record_turn 会明确告诉你去哪儿配:
无法抽取记忆:没有可用的 LLM 配置。 未配置 API key。请在 ~/.rememberme/settings.json 或项目 settings.json 里设置 ANTHROPIC_API_KEY…
数据目录:npm 版默认落在 ~/.rememberme/data(记忆存在 ~/.rememberme/data/memory/,
画像在 ~/.rememberme/data/profile/PROFILE.md),这是 npm 全局安装形态下自洽的位置。
想改就用 REMEMBERME_DATA_DIR 指定绝对路径。
只读模式(不想让 server 调 LLM、不想花额度):
REMEMBERME_MCP_DISABLE_LLM=1 # 只留 3 个读工具,record_turn 会返回明确错误
MCP server 的实现见
src/mcp/, 整体架构见ARCHITECTURE.md。
人设怎么工作(OCEAN)
Big Five(OCEAN)
学术界公认的 5 维人格模型(每维 0-1):
| 维度 | 含义 | 高分特征 |
|---|---|---|
| Openness(开放性) | 想象力、好奇心、抽象思维 | 喜欢新想法、跨领域联想 |
| Conscientiousness(尽责性) | 条理、自律、可靠 | 先组织再表达 |
| Extraversion(外向性) | 热情、健谈、活力 | 主动扩展话题 |
| Agreeableness(宜人性) | 信任、合作、利他 | 温和、不对抗 |
| Neuroticism(神经质) | 情绪敏感、焦虑 | 高=易焦虑 / 低=稳定 |
怎么运作
- 新建会话时:弹窗"简单描述你想要的人格"(1 句话即可)
- LLM 翻译:把你说的描述转成 5 维数值 + 自由文本偏好
- 保存:写入
data/personality/{sessionId}.json - 之后稳定不变:这个文件是会话的"人设真相来源"
- 每次 system prompt 注入:把数值 + 行为描述 + 自由偏好告诉 LLM
Skip 怎么办
不填描述直接关掉弹窗 → 用默认 OCEAN(全 0.5)+ 通用 preferences 继续对话。可以之后用 /learner reset 重置。
反馈叠加
每次用户消息后,背景跑反馈检测器(fire-and-forget):
- 正面反馈("对,就是这个")→
positivePatterns累积 - 负面反馈("太啰嗦")→
negativePatterns累积 - 中性(新话题)→ 不写
这些观察不写回人设 JSON,而是累积在 data/learned-prefs/{userId}.json。下一轮 system prompt 合并人设 + 反馈观察:
【大五人格】
- Openness: 0.85(高开放性:喜欢新想法、跨领域联想)
- ...
【用户过去喜欢的】(反馈学习)
- 用户喜欢举具体例子
- 用户喜欢引用典故
【核心原则】人设 + 反馈都是参考,不是束缚。灵活调整。
反馈优先于人设:用户说"不要 X"时,以反馈为准。
目录结构
rememberme/
├── README.md / README.en.md ← 用户文档
├── ARCHITECTURE.md ← 开发者文档(架构、数据流、模块)
├── USER_MANUAL.md ← CLI 用户手册
├── package.json ← scripts: start, dev, repl, web, mcp, build:mcp
├── server.json ← MCP Registry 登记清单
├── settings.json.example ← API key 配置模板(真身 settings.json 不入仓)
├── data/ ← 运行时数据(gitignored)
│ ├── sessions/ ← 会话历史
│ ├── learned-prefs/ ← 反馈学习数据
│ ├── memory/ ← 记忆文件
│ ├── timeline/ ← 情绪时间线
│ ├── profile/ ← 用户画像
│ └── personality/ ← OCEAN 人设(per-session)
├── locales/ ← i18n 词条(zh-CN / en)
├── web/ ← 网页前端
│ ├── index.html
│ ├── style.css
│ └── app.js ← SSE 流式消费
├── src/ ← 核心代码
│ ├── index.ts ← REPL 入口
│ ├── web.ts ← 网页后端 (Bun.serve + SSE)
│ ├── provider.ts ← LLM provider 抽象(Anthropic + OpenAI 兼容)
│ ├── profile.ts ← 用户画像
│ ├── memory.ts ← 5 类记忆
│ ├── timeline.ts ← 情绪时间线
│ ├── reflection.ts ← 每日反思
│ ├── prompt.ts ← 5 层 system prompt 组装
│ ├── compact.ts ← auto-compact
│ ├── sessions.ts ← 会话管理
│ ├── feedback-detector.ts ← 反馈分类器
│ ├── persona-learner.ts ← 动态人设学习器
│ ├── bigfive.ts ← OCEAN 数据模型
│ ├── persona-init.ts ← 人设初始化(描述 → OCEAN)
│ ├── classify.ts ← 情绪识别 + 记忆召回(side-query)
│ ├── evolution/ ← 自进化层(curator / lifecycle)
│ ├── mcp/ ← MCP server(npm 包 rememberme)
│ │ ├── index.ts ← 入口(stdio 传输 + stdout 保护)
│ │ ├── server.ts ← 装配 4 个工具
│ │ ├── config.ts ← 数据目录 / settings 路径解析
│ │ ├── provider.ts ← server 自己的 LLM provider
│ │ ├── instructions.ts ← instructions(教宿主何时调 record_turn)
│ │ ├── build.ts ← 分发产物构建(prepack 用)
│ │ └── tools/ ← list_memories / read_memory / read_profile / record_turn
│ └── loop.ts ← runTurn 核心
└── personality/ ← 性格 markdown 文档
不在仓库里的:
tests/(回归测试)、scripts/(一键脚本与实验脚本)、experiments/(一次性实验脚手架)、dist/(构建产物)。 仓库只保留运行所需和发布所需的代码。
🔒 隐私
RememberMe 自身不上传任何用户数据。所有运行时产物都在 data/ 目录里,且 data/ 在 .gitignore 里——永远不会进 git 仓库:
.gitignore 忽略的运行时数据:
├── data/profile/PROFILE.md ← 你的画像(profile.example.md 模板才入仓)
├── data/personality/*.json ← 你的 OCEAN 人设
├── data/sessions/*.json ← 对话历史
├── data/memory/MEMORY.md + emotion/*.md + event/*.md + reference/*.md ← 记忆
├── data/timeline/*.jsonl ← 情绪时间线
├── data/reflections/*.md ← 反思
├── data/learned-prefs/*.json ← 反馈学习观察
└── settings.json ← API key(用 .example 占位入仓)
本地数据:可以放心
- 在 issue / PR / 截图里贴 PROFILE.md 内容(不会被自动收集)
- 把仓库 push 到公开 GitHub(不会泄露任何对话数据)
- 在简历里列这个项目(评审者只能看到代码和文档)
但有一点要清楚:LLM 调用边界
- RememberMe 要工作必须把对话内容发到你配置的 LLM provider(Anthropic / DeepSeek / OpenAI 等)
- RememberMe 本身不存储这些对话之外的副本,但你信任你的 LLM provider 是前提——这是所有基于 LLM 的应用都共有的限制
- 选 self-hosted / 本地模型(如 Ollama)可以完全规避这个外部依赖
🛠 技术栈
| 层 | 选型 | 理由 |
|---|---|---|
| 运行时 | Bun 1.1+ | 内置 TypeScript / 测试 / HTTP 服务器,零构建步骤 |
| LLM | Anthropic SDK(兼容 OpenAI/DeepSeek/Moonshot) | 通过 baseURL 切换,自定义端点保留 Anthropic 协议 |
| HTTP | Bun.serve | 内置 SSE 流式支持,零额外依赖 |
| 前端 | 纯 HTML / CSS / Vanilla JS | 不引入 React/Vue,3 个文件搞定,便于阅读修改 |
| 存储 | 纯 Markdown + JSON | 用户数据可读、可手改、可 git diff |
| 测试 | bun:test | 346 个用例,运行时跑,约 80s(测试代码不在公开仓库里) |
| 大五人格 | 5 维 0-1 数值 + 自由文本偏好 | 学术标准 + LLM 翻译 + 每会话独立存储 |
| 反馈学习 | LLM 自然语言观察 + 正/负例示例 | 不预定义枚举,开放维度 |
License
Apache License 2.0. 见 LICENSE。
@jokab1074/remembermenpm install @jokab1074/rememberme