> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 时态记忆图

> 从记忆列表到知识图谱：专家如何构建持久化的结构化认知

当你告诉专家「我是做 B 端 SaaS 的」，它记住了。当你后来说「我们最近转向 C 端了」，它不会简单覆盖——而是理解这是一个时间上的变化：你曾经做 B 端，现在做 C 端。

这就是「时态」的含义：记忆有时间维度，事实有生命周期，变化被保留而非覆盖。

## 四层记忆管线

记忆从用户可见的列表，到 AI 蒸馏的知识图谱，分为四层：

<Steps>
  <Step title="记忆列表（用户可见）">
    你可以查看、添加、编辑、删除、启用或禁用每一条记忆。这是你直接交互的层面，拥有完全控制权。
  </Step>

  <Step title="证据快照（不可变）">
    每条记忆被创建时，系统生成一份不可变的证据快照——「为什么记住这件事」的原始依据。即使记忆后续被修改，证据永远保留。
  </Step>

  <Step title="核心事实（AI 蒸馏）">
    定期的整理进程将证据蒸馏为结构化事实——实体（人、概念、工具、项目）和关系（偏好、使用、从属）。**核心事实是当前有效 facts 的读取时投影，不是第二份副本。**
  </Step>

  <Step title="记忆图谱（可视化）">
    核心事实组成一张带时间标签的知识图谱。每个节点是一个实体，每条边是一个关系。你可以在 UI 中可视化浏览。
  </Step>
</Steps>

<Tip>
  整理（consolidation）**永远不会改写你的记忆列表**。你添加的记忆始终是你添加的那样——核心事实只是 AI 从中蒸馏出的结构化投影。
</Tip>

## 实体类型

记忆图谱中的实体分为 10 种类型：

| 类型 | 含义       | 示例                   |
| -- | -------- | -------------------- |
| 人物 | 你提到的人    | 「张总」「我的合伙人」          |
| 偏好 | 你的明确偏好   | 「喜欢 TypeScript」      |
| 约束 | 客观限制条件   | 「预算 5 万」「3 人团队」      |
| 决策 | 明确做出的选择  | 「用 Next.js 不用 Remix」 |
| 项目 | 正在做的事    | 「SaaS 后台重构」          |
| 工具 | 使用的工具和框架 | 「React」「PostgreSQL」  |
| 概念 | 抽象概念或原则  | 「简洁优先」               |
| 组织 | 所属团队或公司  | 「创业团队」               |

实体名称和事实描述的语言跟随证据——中文记忆蒸馏出中文事实，英文记忆蒸馏出英文事实。

## 矛盾处理：不删除，只迭代

当新信息与旧事实矛盾时，系统的处理方式不是「删除旧的」：

1. 旧事实被标记结束时间（「直到上周，用户还在用 JavaScript」）
2. 新事实从当前时刻开始（「从本周开始，用户切换到 TypeScript」）
3. **历史永远保留**——专家能回忆起完整的决策演变

## 记忆整理（Dream）

记忆的蒸馏通过两种速度的「整理」进程完成：

<CardGroup cols={2}>
  <Card title="轻整理（对话后）" icon="bolt">
    每次有质量的对话结束后立即提取关键记忆。提取成功后，best-effort 蒸馏到图谱。快速、即时、不丢信息。
  </Card>

  <Card title="深整理（周期调度）" icon="clock">
    定期调度器扫描未处理的证据，分批蒸馏。每批限制数量，避免单次调用超时。中途失败可续传——已处理的部分不会丢失。
  </Card>
</CardGroup>

每一次图谱变更都以 before/after 快照形式写入操作日志，形成完整的变更审计链。任何整理批次都可以原子恢复。

## 检索：有界且高效

当专家需要回忆时，不是全量搜索所有记忆——而是精确的四步检索：

<Steps>
  <Step title="候选筛选">
    根据当前对话内容，初筛最相关的候选记忆（上限 30 条）。
  </Step>

  <Step title="图谱扩展">
    对候选中的实体在图谱中做 1-hop 扩展——找到直接关联的其他事实。
  </Step>

  <Step title="重排序">
    综合相关性、时间新鲜度、重要程度重排序。
  </Step>

  <Step title="注入上下文">
    取 Top 20 条（不超过 2,000 token）注入当前对话上下文。
  </Step>
</Steps>

<Note>
  「有界」是关键设计决策。全量注入所有记忆不仅浪费 Token，还会淹没真正相关的信息。20 条精选记忆比 200 条泛泛记忆更有用。检索失败时自动降级到确定性的「最新 20 条」策略。
</Note>

## 用户控制权

记忆系统的控制权完全在你手中。在专家的进化页面，你可以通过三个标签页管理记忆：

<CardGroup cols={3}>
  <Card title="记忆列表" icon="list">
    查看、添加、编辑、删除、启用/禁用每一条记忆。这是用户直接操作的层面。
  </Card>

  <Card title="核心记忆" icon="brain">
    查看 AI 蒸馏出的结构化事实——实体、关系、时间标记。只读视图。
  </Card>

  <Card title="记忆图谱" icon="diagram-project">
    可视化的知识网络。节点是实体，边是关系，一目了然地看到专家对你的理解全貌。
  </Card>
</CardGroup>

你还可以开启**临时对话**——本次对话不读取记忆，也不产生新记忆，适合敏感话题。

## 隔离与隐私

记忆严格按专家 × 用户 隔离。用户 A 与专家 X 的记忆完全独立于用户 B 与专家 X 的记忆。跨边界访问一律返回 404——不可枚举，无法探测他人是否有记忆。

专家不会「串记忆」——你和专家的对话内容，另一个用户永远不会通过记忆检索获得。
