长期记忆 | Nexus 文档

记忆适合保存什么

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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