记忆管理
概述
记忆管理页面用于查看和维护账户级记忆。账户级记忆跨组织共享，绑定到个人用户 —— 你在不同组织登录同一账户，记忆都会跟着你。
Agent 新建对话时会自动查询账户记忆，以"用户概况"的形式注入 system prompt。这让 Agent 真正"认识你"。
两种视图
| 视图 | 说明 |
|---|---|
| 列表 | 分页浏览所有记忆条目 + 搜索 + 编辑 / 删除 / 清空 |
| 图谱 | 力导向图可视化，展示记忆之间的关联网络 |
切换视图：页面顶部有 列表 / 图谱 Tab。
列表视图
记忆条目
每条记忆以卡片形式展示：
| 字段 | 说明 |
|---|---|
| 文本内容 | 记忆的核心信息（如"用户偏好 TypeScript"） |
| 置信度 | 提取时的置信度分数（0 ~ 1） |
| 元数据 | 附加信息（来源会话 ID、提取时间等） |
操作
| 操作 | 说明 |
|---|---|
| 搜索 | 按关键词过滤记忆列表 |
| 手动添加 | 输入新的记忆条目 |
| 编辑 | 修改已有记忆内容 |
| 删除 | 移除单条记忆 |
| 清空全部 | 一键清除所有账户级记忆（⚠️ 不可恢复） |
分页
- 默认每页 50 条
- 初始加载 50 条 + 图谱数据
- 底部
加载更多追加下一页
图谱视图
切换到图谱视图可以可视化记忆之间的关系网络：
节点类型
| 类型 | 颜色 | 说明 |
|---|---|---|
| Hub（中心） | 紫色 #6d28d9 |
用户中心节点 |
| Fact（事实） | 蓝色 #2563eb |
单条记忆条目 |
| Entity（实体） | 琥珀色 #f59e0b |
从记忆中提取的实体 |
连线类型
| 类型 | 样式 | 说明 |
|---|---|---|
| 层级关系 | 灰色连线 | Fact → Hub，Entity → Hub |
| 关联关系 | 琥珀色连线 | Entity ↔ Entity 交叉关联 |
交互
- 点击节点：查看详情，支持编辑 / 删除
- 悬停节点：显示完整文本
- 拖拽：调整节点位置
- 缩放：滚轮缩放视图
- 折叠模式：超过 100 条记忆时，中心节点显示计数标签（如 "128 条记忆"）而非所有事实节点
图谱渲染优化（2026-04 更新）NEW
新版图谱引入了双密度门机制，避免节点过多时标签重叠导致不可读：
| 阈值常量 | 值 | 含义 |
|---|---|---|
PILL_READABILITY_MIN_SCALE |
1.5 | 缩放比例小于 1.5x 时不渲染文字标签 |
PILL_MIN_SCREEN_AREA_PER_NODE |
3000 | 每个节点平均占屏面积少于 3000 像素时不渲染文字标签 |
两个条件同时满足才渲染标签。未达到时只显示圆点，保持视觉清晰。
实体类型颜色稳定化：所有 Entity 节点的颜色通过 djb2 hash 计算 —— 同一类型实体在不同视图、不同时间都保持同一颜色，便于视觉辨认。10 色调色板支持无限类型循环。
实体类型字段修复：sourceTypes 和 targetTypes 字段现已正确传递到前端图谱，之前因丢失导致所有节点都回退到灰色的 Bug 已修复。
记忆写入方式
手动添加
在列表视图点击"添加"按钮，输入记忆文本保存。
对话自动提取
Agent 在对话中自动检测值得记住的信息并存储：
| 触发方式 | 示例 | 置信度 |
|---|---|---|
| 显式命令 | "记住我喜欢用 TypeScript" | 0.99 |
| 隐式检测 | "我叫张三，是前端开发" | 0.93 |
详细的提取机制请参考 三维记忆系统。
记忆在对话中的作用
- 新建对话：系统查询账户级记忆概况，以"用户概况"形式注入 system prompt
- 对话中提问：Agent 根据用户问题语义查询相关记忆（memory_query 工具）
- 记忆更新：新的对话信息可能触发已有记忆的更新或合并
跨账号 Gateway 隔离 NEW
为保证隐私，跨账号 Gateway 派发的会话不会访问到你的账户记忆：
- 当你的节点设为 enterprise 被同组织其他账号调用时，执行过程无法读取你的账户记忆
- 只有企业记忆（组织级）可被跨账号会话访问
- 本机自己的会话不受影响
详见 多节点架构 — 跨账号隔离。
操作指南
如何手动添加记忆
- 打开 APP → 设置 → 记忆
- 在列表视图中，点击 添加 按钮
- 输入你希望 Agent 记住的信息，例如："我偏好使用 TypeScript 编写代码"
- 保存
效果：下次新建对话时，Agent 会知道你偏好 TypeScript，在涉及代码的回复中自动使用 TypeScript。
如何查看记忆图谱
- 在记忆管理页面，切换到图谱视图
- 中间的紫色大圆是你的用户中心节点
- 蓝色节点是记忆条目（如"喜欢 TypeScript"），通过灰色连线连接到中心
- 琥珀色节点是提取的实体（如"TypeScript"、"React"），实体之间用琥珀色连线表示关联
- 操作：
- 点击任意节点查看详情，可编辑或删除
- 拖拽节点调整位置
- 滚轮缩放视图
- 悬停节点查看完整文本
如何清空记忆
- 在记忆管理页面，点击 清空全部 按钮
- 确认清空操作
注意：清空操作不可恢复。清空后，Agent 在未来的对话中不再知道你的任何偏好、背景和历史信息。Agent 会像第一次见面一样与你交流。只有在确实需要"重新开始"时才使用此功能。
记忆对对话质量的影响
| 记忆状态 | 对话体验 |
|---|---|
| 记忆丰富且准确 | Agent 了解你的身份、偏好、项目背景，回复个性化且精准 |
| 记忆为空 | Agent 像初次见面，每次都需要你重新解释背景和偏好 |
| 记忆过时或错误 | Agent 可能基于错误信息给出不合适的建议 |
| 记忆过多 | 注入到对话的记忆概况变长，可能占用上下文空间 |
建议：定期（如每月一次）浏览记忆列表，删除过时或不再准确的条目。保持记忆精简且准确是获得最佳对话体验的关键。
自动提取 vs 手动添加
| 对比 | 自动提取 | 手动添加 |
|---|---|---|
| 触发方式 | Agent 在对话中自动检测 | 你在记忆管理页面手动输入 |
| 准确性 | 取决于置信度阈值，可能遗漏或误提取 | 完全由你控制，100% 准确 |
| 适用场景 | 日常对话中自然积累 | 希望 Agent 记住特定信息（如项目规范） |
提示：两种方式可以结合使用。让自动提取处理日常信息，对于重要的项目规范和工作偏好，建议手动添加以确保准确。
常见问题
为什么 Agent 没有记住我说的话？
可能的原因：
- 置信度不够：信息不够"像需要记住的事实"。尝试更明确地表达："请记住，我喜欢用深色主题。"
- 被排除规则过滤：纯提问、闲聊、代码块中的内容、时效性信息（如"今天天气"）不会被提取。
- 记忆提取延迟：每轮对话结束后才提取记忆，如果对话被中断，可能未完成提取。
为什么 Agent 基于错误的记忆回答？
你可能有过时的记忆条目。解决方法：
- 打开记忆管理，搜索相关记忆
- 找到错误的条目，点击编辑更正或删除
- 也可以在对话中说"忘掉我之前说喜欢 Python，我现在用 TypeScript"
记忆占多少上下文空间？
系统在新建对话时会将记忆以概况形式注入 system prompt，通常占 200-1000 tokens（取决于记忆数量）。相对于 128K-200K 的上下文窗口，占比很小，不会显著影响可用空间。
相关文档
- 三维记忆系统 — 记忆系统技术详解（含企业级和会话级）
- 高级设置 — 企业记忆 — 企业级记忆管理（管理员）
- 多节点架构 — 跨账号 Gateway 隔离