Repository avatar
Other Tools
v0.22.0
active

RememberMe

io.github.SoHardToMakeAName/RememberMe

长期记忆 MCP server:记住用户是谁、经历过什么、情绪模式如何,跨会话不丢。

Documentation

RememberMe

English | 中文

CI npm

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. 新建会话时:弹窗"简单描述你想要的人格"(1 句话即可)
  2. LLM 翻译:把你说的描述转成 5 维数值 + 自由文本偏好
  3. 保存:写入 data/personality/{sessionId}.json
  4. 之后稳定不变:这个文件是会话的"人设真相来源"
  5. 每次 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 服务器,零构建步骤
LLMAnthropic SDK(兼容 OpenAI/DeepSeek/Moonshot)通过 baseURL 切换,自定义端点保留 Anthropic 协议
HTTPBun.serve内置 SSE 流式支持,零额外依赖
前端纯 HTML / CSS / Vanilla JS不引入 React/Vue,3 个文件搞定,便于阅读修改
存储纯 Markdown + JSON用户数据可读、可手改、可 git diff
测试bun:test346 个用例,运行时跑,约 80s(测试代码不在公开仓库里)
大五人格5 维 0-1 数值 + 自由文本偏好学术标准 + LLM 翻译 + 每会话独立存储
反馈学习LLM 自然语言观察 + 正/负例示例不预定义枚举,开放维度

License

Apache License 2.0. 见 LICENSE。

NPM
@jokab1074/rememberme
Install Command
npm install @jokab1074/rememberme
Runtime: npx