DuduLove Memory

为 AI 与个人 Agent 提供可自托管的长期记忆与身份连续性。

DuduLove Memory 不只是把聊天片段存起来，再用向量搜索找回来。它把 Resident（记忆身份） 当作长期主体：同一个 Resident 可以从不同客户端、不同模型或不同 Agent 入口继续使用同一份身份、历史与授权；多个 Resident 可以共享现实资料，同时保留彼此隔离的私人经历和理解。

它想解决的不是“怎样让 AI 记得更多”，而是一个更难的问题：

怎样让过去真正参与它现在是谁，同时允许记忆被修正、被遗忘、被重新理解。

项目可以完全运行在自己的电脑或服务器上。基础记录、关键词搜索、身份隔离和管理不依赖外部模型；语义检索与资料整理按需接入用户自己的 OpenAI 兼容模型服务。

为什么是 Resident

很多记忆系统默认围绕一次会话、一个前端或一个 Agent 实例组织数据。DuduLove Memory 把这些都视为入口，而不是身份本身。

• Resident 是主体：每个身份拥有固定 ID。改名、换客户端、换连接方式，不会改变记忆归属。

• Surface 只是入口：网页、MCP、HTTP 客户端或个人 Agent 可以连接到同一个 Resident。

• 共享现实不等于共享内心：共同事实可以进入 world，每个 Resident 对同一件事形成的私人经历仍留在各自的 private。

• 模式不必拆成人格：聊天、工作、任务和唤醒可以使用不同召回配方，但仍然属于同一个 Resident。

因此，同一件事可以拥有一份共同事实，也允许不同 Resident 留下不同的理解。记忆不必把所有人压成同一个视角。

记忆不是一个向量查询

DuduLove 的上下文召回分成不同职责，而不是把所有内容丢进相似度排序：

• Identity：少量稳定身份、关系、边界与长期倾向。它们不应该因为关键词不相似就消失。

• Association：围绕当前话题自然联想相关经历，并结合会话级 Recall Ledger，减少同一条记忆在短时间内反复浮现。

• Evidence：在需要确认历史事实、来源或旧决定时，优先保留来源信息，而不是只返回一段脱离出处的摘要。

• Work recall：工作身份会额外关注项目经验、规则、明确记录的未完事项和实际行动结果。

上下文由统一的 Resident Context Assembler 按身份、权限、模式、话题和 token 预算组合，再交给当前模型。

记忆也需要治理

长期记忆不是模型写下一句话就永久成立。

DuduLove 的写入经过统一的 Memory Admission。系统会处理归属、生命周期、来源、重复内容和敏感运行时数据，并保留修改与拒绝记录。对于带来源的资料，调用方提供的标签本身不会自动变成可信证据；来源需要由服务端能够验证的记录或受控流程确认。

被用户拒绝的记忆会留下 rejection 记录，避免相同内容或来源被后台整理后重新写回来。依赖已拒来源的派生内容也不会继续作为正常自动召回中的可信依据。

这意味着“记错以后能真正改掉”与“记住”同样重要。

四类主要资料

候选、长期有效、未完、归档和拒绝等变化由 lifecycle 表达，不需要不断增加新的“记忆柜子”。

主要功能

开始使用

需要 Node.js 22.13 或更新版本。

npm ci --ignore-scripts
npm start

1. 浏览器打开终端显示的地址，默认是 http://127.0.0.1:8787。

2. 设置管理密码。

3. 点击「＋ 记忆身份」，创建第一个 Resident。

4. 保存一条记忆，在「身份与连接」复制连接。

5. 将连接填写到支持 MCP 或 HTTP API 的客户端。

记忆保存在本机 data/ 目录。需要跨设备访问时，按部署说明配置 HTTPS 地址。

模型服务是可选的

DuduLove 可以在完全不配置模型服务的情况下完成：

• 身份与权限管理

• 记忆保存、编辑、删除和恢复

• 关键词搜索

• 上下文组装

• 活动记录与基础近期简报

语义检索和资料整理使用用户自行配置的 OpenAI 兼容接口。启用前请查看资料发送范围与调用条件。模型服务故障不会删除原始资料，语义检索不可用时仍可继续使用关键词搜索。

使用与接入

• 日常管理、分类与授权

• Resident 跨 Surface 接入指南

• HTTP 与 MCP 接入

• 给接入 Agent 的操作说明

• 客户端连接与身份选择接口

• 整理、活动与近期简报

• 模块、连续性与数据流

• 部署、备份、恢复与升级

开发与维护

一个 Node.js 服务同时提供 HTTP API、MCP 和静态管理网页。数据由本地文件保存。

npm test
npm run check
npm run pack:release

自动测试使用隔离的临时目录和虚构资料。参见参与贡献、版本记录与验证情况。

MIT License · 依赖许可证 · 安全与数据