Skip to content

wukun2005-gif/GraphMe

Repository files navigation

GraphMe — Agent Memory 可视化系统

GraphMe Demo

记忆不是孤岛,而是星座——让每一颗记忆原子在时空中相互关联,照亮那些深埋已久的高价值时刻。

📺 观看完整 Demo Video


为什么要做 GraphMe?

AI 正以前所未有的速度渗透到我们的日常生活——智能音箱记得你的音乐偏好,陪伴机器人知道你孩子的名字,学习助手了解你的知识盲区。但这些 AI agent 记住的东西,对用户来说始终是一个黑盒

你不知道 agent 记住了什么、不知道它为什么会做出某个回应、不知道哪些记忆该留着、哪些该删掉。更糟的是,不同 agent 应用之间的记忆是天然隔离的——你的陪伴机器人和学习助手各自存储了关于你的碎片,却从未被整合成一幅完整的"你"的画像。

GraphMe 想解决的核心问题:把 AI agent 的"记忆黑盒"打开,变成用户可感知、可探索、可管理的数字记忆资产。

面向什么场景和领域

GraphMe 覆盖 AI agent 应用的五大核心场景领域:

领域 说明
技能学习 构建型 agent 记录的编程、搭建、创意等学习过程记忆管理
创意构建 模块化创作、项目作品的记忆留存与回顾
日常陪伴 陪伴型 agent 在日常互动中积累的情感与生活记忆
情感连接 特殊时刻、情感表达、被理解的瞬间——AI 陪伴的深层情感记忆
远程看护 agent 辅助下的家庭看护与远程监护记忆

目标用户是谁

GraphMe 面向五类核心用户,当前 Demo 以家庭家长视角为默认展示:

角色 核心诉求
家庭家长(Primary) 了解 AI 和孩子聊了什么、学到了什么、有没有需要关注的异常
儿童/青少年(End User) 回顾和 AI 的趣味时刻,获得陪伴感和认同感
极客/开发者(Influencer) 深入理解 AI 记忆机制,优化和干预 agent 认知行为
陪伴需求者(Emotional) 独居/异地/老年人,需要被"懂"的情感连接
教育工作者(Institutional) 管理多台 agent 教学设备,追踪学习效果和课程覆盖

快速开始

前置要求

  • Node.js >= 18
  • npm >= 9

安装与运行

git clone https://github.com/wukun2005-gif/GraphMe.git
cd GraphMe
npm install
npm run dev

浏览器打开 http://localhost:5173。首次访问会自动进入 4 步引导——认识你的记忆星云、学会点击粒子、找到侧栏导航、认识聊天助手。右上角 ▶ 按钮可随时触发一键演示模式。

? 查看全部快捷键。


竞品调研与差异化定位

我们调研了当前市场上与"个人记忆 / 知识管理 / 可视化分析"相关的四类产品:

类别 代表产品形态 核心能力 与 GraphMe 的关系
全功能工作台 以文档、数据库、页面为基本单元的一体化协作工具 结构化信息管理、多视图切换、团队协作 面向通用信息组织,不区分"记忆"和"笔记",缺乏 AI 推理层
双向链接笔记 以 Markdown 文件为基础、支持 [[双向链接]] 和关系图谱的本地化知识库 原子化笔记、反向链接、2D 图谱 关系图谱仅展示"你手动建立的链接",不做语义聚类或 AI 推断
可视化白板 以无限画布 + 卡片为交互范式的思维整理工具 自由布局、空间思维、头脑风暴 侧重手动组织,不处理 AI agent 产生的记忆数据,无自动聚类能力
AI 记忆助手 基于 LLM 的个人伴侣 / 笔记应用,自动记录对话或屏幕内容 被动记忆记录、时间线回放、自然语言检索 记忆以时间线或列表展示,缺少空间化、多维度的记忆管理界面

基于以上发现,GraphMe 中重点验证以下五个差异化方向:

维度 通用工具 GraphMe
记忆模型 单层(笔记=记忆) 双层(Raw + Insight)
可视化 2D 图谱 / 列表 / 时间线 3D 语义空间 + 情绪着色
视角 单一视角 4 维度空间重排(顶部切换)+ 分类过滤(左侧导航),可组合使用
价值量化 CQI 评分 + 遗忘预警
AI 可解释性 黑盒 对话记忆链接 → 空间追溯
数据模型 扁平字段 10 维度(时间/空间/社交/情绪/活动/感官/语义/价值/叙事/Agent状态)

设计思路

GraphMe 的名字来源于 Graph(图谱)+ Me(我)——你的记忆不是散落的点,而是相互关联的认知网络。

双层记忆架构

GraphMe 将记忆分为两个层次:

原始记忆(Raw Memory) 洞察记忆(Insight Memory)
是什么 用户直接输入或系统自动记录的事件 从原始记忆聚类推理生成的高阶认知
好比 "发生过的事" "被发现的模式 / 趋势 / 信念"
性质 事实性的,不可推翻 概率性的,随新数据演进
操作 只能被删除 只能被新版本替代(旧版本保留为历史)

当新的原始记忆加入时,系统会重新推理并生成新版本的洞察记忆——这正是心理学中巴特莱特的"图式"理论和**皮亚杰的"同化与顺应"**在数字记忆领域的映射:人的记忆不是简单回放,而是用已有心理框架不断重构。GraphMe 让这个动态过程变得可见。

从向量空间到 3D 记忆星云

AI 的记忆天然存在于多维向量空间中。GraphMe 不做炫技的视觉效果,而是让你直观感受到向量空间中那些天然存在的关系:

  • 语义距离(Semantic Distance)→ 粒子的远与近——越相关的记忆越靠近
  • 聚类(Clustering)→ 簇群的形成与重叠——相似记忆自动聚集成簇
  • 分类(Classification)→ 粒子的颜色与归类——不同类别的记忆用颜色区分

你拖拽、旋转、缩放这个 3D 记忆星云时,操控的不只是视觉效果,而是对向量空间关系的物理直觉。


功能亮点

3D 记忆星云 · 不是散点图,是活的星云

每颗粒子不是冰冷的数据点——圆形辉光纹理 + AdditiveBlending 叠加出弥漫的星云质感。粒子大小反映记忆重要性(里程碑 ×1.5),透明度有随机层次,Insight 节点缓慢自转带着呼吸感的脉冲缩放。背景里 100+ 颗微弱的星尘粒子缓慢漂移,填补空间的留白。

  • 情绪轨迹线 — 同一天内的记忆粒子用渐变色曲线串联,线色从起点情绪过渡到终点情绪,一眼看出"上午好奇 → 下午沮丧 → 晚上感激"的情绪流动
  • 记忆共振波纹 — 选中一条记忆时,共享 storyline 或人物的粒子泛起同心圆涟漪,"记忆不是孤岛"从隐喻变成视觉体验
  • 记忆潮汐 — 频繁回顾的记忆粒子被青色光晕包裹,沉睡的记忆暗淡发灰,濒临遗忘阈值的粒子微弱地呼吸式脉冲
  • 氛围温度计 — 可见粒子的情绪主导色会微调整个星云的背景色温:快乐多时暖金弥漫,悲伤多时冷蓝笼罩

记忆探索 · 发现你自己都不知道的连接

GraphMe 提供一整套记忆关联发现工具,帮你看见记忆之间那些隐藏的对话:

工具 做什么 一句话
🔗 找相似 多维特征匹配,返回 Top 5 相似记忆 "还有哪些记忆和这条很像?"
🪃 回旋镖 跨越 ≥30 天的本质相似记忆 "8 个月前的你,也经历过完全相同的模式"
📞 传声筒 链式探索,从一条记忆走到完全意想不到的另一条 "循着线索走一条记忆小路"
🌍 对跖点 10 维空间中距离最远的记忆 "那个和你完全相反的你"
回声记忆 打开记忆时自动发现跨时间的呼应 "3 个月前的今天,你也在公园"
🎲 机缘引擎 随机碰撞两条表面无关的记忆 "你知道吗?这两件事都发生在周六上午"

记忆生命周期 · 从诞生到告别

记忆不只被记录和查看——它有完整的生命周期:

  • ⏳ 时间胶囊 — 封存一条记忆,设定未来的某天自动开启。"给 3 个月后的自己:还记得这天吗?"
  • 🎁 记忆盲盒 — 每天首次打开时,星云中央浮现旋转礼盒,点开是一条被遗忘太久的高价值记忆
  • 📅 那年今日 — 类似 iPhone 照片的"回忆",自动浮现历史上的今天
  • 📌 间隔复习 — 基于遗忘曲线的主动提醒:哪些记忆快被忘了?点"重温"重置衰减曲线
  • 🪦 记忆摆渡 — 删除不是冷冰冰的消失。长按删除键进入告别仪式:写一段告别语,选择释放方式——沉入深海 / 化为星光 / 随风飘散。粒子在 3D 星云中执行对应动画后消散

AI 透明性 · 打开黑盒

GraphMe 坚信:AI 的记忆不应该对用户是黑盒。

  • 🗺️ 认知地形图 — AI 眼中的你的全景画像:概念山脉、知识河流、情感气候带、人物岛屿、未探索迷雾区。底图可触发"小哥为你写封信"——基于全量记忆生成一封有温度的书信
  • 🤔 AI 困惑日记 — AI 主动告诉你"关于你,我还有很多不懂的地方":矛盾的洞察、低置信度的推断、长期空白的认知维度,以及建议你回答的问题
  • 🦋 蝴蝶效应 — 纠正一条洞察时,脉冲波从被纠正粒子向外扩散,受影响的关联洞察依次闪烁,连线短暂变红。"改了一个字,整个认知网络如何重塑"变得可见
  • 🔬 溯源链 — 逐步展开洞察的推理过程:从原始记忆到聚类到结论,每一步可展开查看具体记忆,可在任一步骤点击"这里不对"

记忆叙事 · 你的记忆会讲故事

  • 🌙 梦境生成器 — 随机抽取 3-5 个跨类别碎片,拼接成超现实叙事。"你梦见公园变成了教室,爸爸正在编程,而你笑得停不下来"
  • 📖 阅读模式 — 全屏沉浸式翻书,每条记忆是一张书页,左右箭头翻页,3D 星云中当前粒子同步高亮
  • 🎬 记忆微电影 — 自动播放最近 N 条记忆,3 秒翻页,背景色随情绪渐变,"这就是你最近的 N 个瞬间"
  • 📊 年度记忆报告 — Spotify Wrapped 式年度回顾:情绪分布饼图、月度活跃柱状图、Top 3 高光时刻、年度关键词、记忆人格总结

记忆管理 · 每一条都值得被好好对待

  • 收藏集 — 多主题收藏夹("爸爸和我"、"编程里程碑"),收藏的记忆在 3D 中有光晕标识
  • 标签系统 — 自定义标签("重要"、"好笑"、"待回顾"),侧栏按标签分组查看
  • 多维过滤 — 12 种情绪色块筛选 + 4 种视图切换(全局/家庭/学习/情绪)+ 时间轴滑块,可组合使用
  • 3D 搜索 — 顶部搜索框直接在星云中定位,匹配粒子高亮放大,其余半透明
  • 撤销系统 — 删除和编辑都可撤销(5 步快照),操作后 Toast 带快捷撤销按钮
  • 数据持久化 — 所有操作保存到 localStorage,刷新不丢失
  • JSON 导入 — 支持从外部 Agent 导入记忆数据(含 ChatGPT 演示数据)
  • 全局快捷键1-4 切换视图、Ctrl+F 搜索、Ctrl+Z 撤销、? 快捷键帮助

记忆银行 · 让记忆成为你的数字精神资产

GraphMe 将每条记忆视为用户的数字精神资产,通过推理、关联与趋势分析实现资产增值——让 GraphMe 从"记忆查看器"进化为"记忆理财顾问"。

  • 生命维度投资组合 — 快乐、社交、创意、探索等多维度资产的当前值、趋势与预测
  • 正/负资产区分 — 正能量记忆为正资产(鼓励保持),负面记忆为负资产(预警规避)
  • 记忆利率排行 — 展示不同类型记忆的增值潜力,帮助用户判断时间投入方向
  • Mental Model 画像 — 基于全量记忆数据推理生成的自然语言行为模式画像,动态演化
  • 情感旅程地图 — 连续贝塞尔曲线展示情绪随时间的流动,颜色随情绪渐变
  • 情绪日历热力图 — GitHub 贡献图风格,一格一天,一眼看出哪些天情绪好

License

MIT

About

3D记忆星云可视化系统 — 将多维向量空间转化为可感知、可探索、可管理的记忆图谱。支持双层记忆架构(原始/洞察)、10维剖面、版本演化、CRUD管理和Chat Assistant | Agent Memory Graph with visualized effect, for raw and inference memory atoms.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages