---
url: /zh/guides/memory.md
---
# 长期记忆

Memoh 的结构化长期记忆让 Bot 在**多路会话**里也能用上以前留下的事实。用 **Memory** tab 前，先给 Bot 配好 **Memory Provider**。

## 先决条件

1. 在 [记忆提供方](../integrations/providers/memory/builtin.md) 里建一个（内置、Mem0、OpenViking 等）。
2. 打开 Bot **General**。
3. **Memory Provider** 里选中。
4. 保存。

没选提供方，就没有正在使用的记忆后端。

***

## 在做什么

记忆条目的存、取、搜都由当前提供方实现；按提供方类型，可能是内置记忆图、pgvector 向量、或外接 API。用户发消息时，Memoh 会尝试取出相关记忆塞进当次上下文。

本页说 **长期记忆**；**会话写太长** 要压短，是另一件事，见 [会话上下文压缩](./compaction.md)。

***

## 在界面里

### 建记忆

* **New Memory**：手打一条。
* **From Conversation**：从已有对话里抽成记忆。

### 搜与管理

* **Search**：按 id 或文字筛。
* **Edit**：改内容。
* **Delete**：不要就删。

***

## 记忆压缩（注意：不是会话压缩）

积累多了可以在 **Memory** tab 对**存储侧**做 **Compact**：合并重复、去陈旧、压噪声。

参数：

* **Ratio**：压缩比，如 `0.8`、`0.5`、`0.3`；值越低，压得越激进。
* **Decay Days**：可选，把压缩范围限定在超过这个天数的旧记忆上，新记忆不动。

这和 [会话上下文压缩](./compaction.md) 不同：后者是**单路会话**里把 prompt 压短，不改库里长期记忆条目的存法与合并结果。

***

## Rebuild

**Rebuild** 会按当前设置**整库重索引**。换了 embedding 模型、索引乱了、想全量用新设置跑一遍时有用。页面上可跟进度。

***

## 状态

**Memory** tab 会显示当前该 Bot 的记忆后端的 **Connected / Error**，排障时先看一眼。

***

## 用量

可看 **总条数**、**索引是否跟上** 等，心里有数再调策略。

***

## 和「会话里那段对话」的对比

| 概念 | 作用范围 | 在哪动 | 改变什么 |
|------|----------|--------|----------|
| **记忆压缩** | 长期记忆提供方 | Memory tab | 改存储里条目怎么合并/精简 |
| **上下文压缩** | 当前这一路会话 | 状态区或 `/compact` | 用摘要把**本会话**历史变短，给后面轮次用 |

要减「跨会话噪声」、整理记忆库 → 用 **记忆压缩**。\
要减「这一路聊太长了」→ 用 [会话上下文压缩](./compaction.md)。

***

## 和 Bot 的关系

* 聊的时候会按配置去搜记忆。
* 具体用哪种后端、embedding 等，在**提供方**上配，见 [记忆提供方](../integrations/providers/memory/builtin.md)。
* 长期记忆是 Bot「个性与事实」里很大一块来源。
