10分钟看会Hindsight记忆可视化

10分钟看会Hindsight记忆可视化

【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight

Hindsight 自带控制面板，用 Constellation 星座图、Tree 知识页和记忆表格三个视图，把记忆库画成一张可交互的记忆网络。记忆到底存在哪、连了什么、为什么记错，翻 API 文档很难说清，图形化展示记忆关系可以直接看图定位问题。读完你不需要写代码，就能打开控制台查清"代理为什么记错了"。

打开 Hindsight 控制面板

export OPENAI_API_KEY=sk-xxx docker run -it -p 8888:8888 -p 9999:9999 \ -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY \ -v hindsight-data:/home/hindsight/.pg0 \ ghcr.io/vectorize-io/hindsight:latest

浏览器访问http://localhost:9999，选一个记忆库，左侧栏就是全部视图。

Hindsight控制面板总览与记忆星座视图

逐个拆解记忆可视化视图

Knowledge 视图：Tree 看知识页怎么拼

• 左侧是知识页树，右侧是页面正文
• 点 "Backed by N memories" 可回看来源记忆
• 适合回答："这条结论从哪些记忆推出来"

Knowledge 视图：Graph 看记忆网络全貌

• 力导向图，滚轮缩放、拖拽平移
• 大圈是主题聚类，节点越大连接越多
• 适合回答："记忆网络里哪个主题最中心"

Knowledge页面树与记忆可视化知识网络

Data 视图：表格核对原始记忆

• 一行一条记忆，带标签和时间
• 点开展开原文、来源和时间戳
• 适合回答："这条细节当初到底存没存对"

数据从哪来

1. 对话或文档经 retain 操作写入记忆库
2. 系统切块，LLM 提取出单条事实
3. 整合管道定期把零散事实聚成知识页，页面间再建关联
4. 页面和关联喂给星座视图，记忆网络就画出来了

信息冲突时走合并策略：替换旧值、融合新旧，或保留历史并打时间戳。

走通一次排查：代理记错了东西

1. 打开 Data 视图，搜索记错的关键词，确认原始事实存的是不是对的
2. 切到 Knowledge 视图，找到对应页面，对比正文和事实是否一致
3. 页面有 Needs refresh 标签，点刷新，看整合结果是否修正
4. 进 Recall 视图，用代理当时的原话再查一遍，检查证据链
5. 若 Recall 结果不对，回 Graph 看该主题节点的连线，找孤立或断链的记忆

避坑与调优

不配 LLM 就没有图形

• 没有 LLM 时只存原始事实，不生成知识页，Graph 一片空
• 用支持工具调用的模型，否则整页刷新会静默失败

分清 Recall 和 Reflect

• 混淆两者会看到证据而非推理结论
• 排查"答非所问"先查 Recall 是否取到正确记忆

排查前先确认 bank

• 多 bank 环境下选错记忆库，图上看全是无关记忆
• 顶部下拉切换 bank，星座图随库刷新

关键文件索引

• hindsight-control-plane/src/components/constellation.tsx
• hindsight-control-plane/src/components/data-view.tsx
• hindsight-control-plane/src/components/knowledge-base-view.tsx
• hindsight-control-plane/src/app/api/entities/graph/route.ts

把一条自己的对话 retain 进记忆库，等几分钟后打开 Knowledge 的 Graph 模式，你会看见第一个节点被点亮。

【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight