# 长期记忆

查看和修正长期记忆，配置自动记忆与后台整理。

## 记忆适合保存什么

长期记忆用于跨会话保留稳定偏好、项目背景和反复需要的信息。例如报告格式、项目术语和已确认的工作约定。临时进度、一次性错误日志和仍待确认的推测更适合留在当前对话。

NXS 的长期记忆位于当前 Agent 工作区的 `MEMORY.md` 和 `memory/`。会话摘要单独保存；与长期记忆分别管理。

## 记忆、技能和交接文件怎么分工

| 信息 | 放在哪里 | 原因 |
| --- | --- | --- |
| 团队长期使用的术语和格式 | 长期记忆 | 多次会话都可能需要 |
| 报告复核的固定步骤 | Skill | 有触发条件、流程和验收方法 |
| 今天任务进行到哪一步 | 任务交接文件 | 随执行变化，不应长期当成事实 |
| 一份报告的完整原始材料 | 工作区文件 | 需要保留原文与来源 |
| API Key 和密码 | 对应设置表单 | 不应进入可参与模型上下文的记忆 |

## 用一次修订建立可靠记忆

假设团队原来使用五段周报，现在已确定改为三段。先在目标 Agent 的记忆页打开现有条目，确认它记的是哪一版，再在该 Agent 的会话说明替代关系。

```text
本项目从现在开始采用“进展、风险、下周计划”三段周报。
请把这条已确认规则写入长期记忆，替换本项目原有五段格式。
不要把这次修改扩大到其他项目。完成后给出记忆文件和修改摘要。
```

打开它返回的文件，检查旧规则是否仍与新规则并列。如果两条都保留却没有适用范围，下一次任务仍可能选错。修正时明确项目和生效范围，而不只说“记住新格式”。

然后新开同一 Agent 的会话，用一份教学记录要求生成周报。检查格式是否正确；如果没有采用规则，先让它读取刚才确认的记忆文件，再排查是否选错 Agent 或引擎。一次成功不能证明所有未来对话都会无误，应保留可查看的规则。

## 自动记忆和自动整理

![常规设置中的自动记忆与自动整理记忆开关](/images/docs/settings-general.png)

*桌面版实图，具体开关状态以你的设置为准。*

在 **设置 → 常规** 中可以配置 **自动记忆** 与 **自动整理记忆**。前者从对话提取值得保留的信息，后者在后台合并重复记忆并更新索引。

自动处理会调用模型，具体行为取决于运行引擎和模型能力。保存设置后，可打开记忆文档查看处理结果。

## 自动处理之后如何检查

自动记忆和自动整理是两个开关，分别对应提取和整理。关闭其中一个不等于删除已有文件，也不等于另一项同时关闭。

检查时关注内容而不只看开关。新条目是否来自已确认事实，索引是否指向正确主题，过时约定是否被替换，都是需要核对的结果。模型把推测写成结论时，应提供明确更正，不要靠后续对话慢慢覆盖。

## 避免错误长期保留

对过时内容直接说明替代事实和生效范围。存在两个相互冲突的版本时，让 Agent 保留已确认的版本，并移除过时规则。

不要把 API Key、密码、一次性验证码或其他凭据放进记忆。记忆可能参与后续模型上下文，凭据应使用相应的配置入口保存。

## 删除与备份

新建但从未运行的 Agent 可能没有记忆文件。总索引不能像 `memory/` 中的普通主题文档一样直接删除；编辑记忆也不会改写过去的聊天记录。

删除前确认选中的文档和 Agent，必要时保留副本。关闭自动记忆不会自动删除已有内容。页面显示“删除结果未确认”时先核对，确认原操作结果后再决定是否重试。

完整数据备份会覆盖工作区记忆，详见[备份指南](/docs/backup)。希望复用一套操作方法时，优先写成[Skill](/docs/skill-authoring)，便于复用和维护。

## 空白和丢失如何区分

从未运行的 Agent 没有记忆文件可能是正常情况。原来存在、迁移后却看不到时，先核对当前 Agent、运行引擎和数据目录，再检查备份；不要先要求重新生成记忆，以免用推测替代原内容。

NXS 的 `MEMORY.md` 和 `memory/` 是本页说明的文件组织。切换运行引擎时，不应假定另一引擎会按同样规则读取和整理。历史聊天也不会随记忆修订一起改写。