记忆工作原理

​

概述

Qoder CLI 每次会话都会重新构造上下文——它不会自动记得上一次会话聊过什么，除非这些信息被显式保存下来。理解 Qoder 记住信息的几种机制，能帮助你把该长期保留的知识固化下来，同时避免让无关内容占满上下文。 Qoder 依赖的信息主要来自三个层面，它们的生命周期和用途各不相同：

​

对话上下文

对话上下文是当前会话中累积的历史——你的输入、Qoder 的回复、每一次工具调用及其结果。它让 Qoder 在一次会话中保持连贯，记得几分钟前你们讨论过什么。 对话上下文有几个关键特点：

• 会话内有效：它只在当前会话中存在。开启新会话时，之前的对话上下文不会自动带过来。
• 容量有限：上下文窗口是有限的。对话越长，占用越多。
• 可管理：你可以主动清理或压缩上下文。

​

管理对话上下文

• /clear：清空对话历史上下文并开启一个新会话，让你"从零开始"。当你切换到一个完全不相关的新任务时很有用。
• /compact：把当前会话的历史上下文总结压缩成更精简的形式，在保留关键信息的同时释放上下文空间。适合长会话进行到中途、上下文开始紧张时。

当对话很长、上下文压力较大时，Qoder 也会在需要时进行压缩。相关的性能和上下文问题排查见 性能、上下文与长会话问题。

​

项目说明

项目说明是由你或团队显式编写的静态记忆，用来告诉 Qoder 项目的结构、开发规范和协作约定。它在每次会话中作为上下文提供给模型，让 Qoder 遵守团队约定。 主要形式有两种：

• AGENTS.md：Qoder CLI 默认的上下文文件名，适合承载整体项目说明和稳定约定。常用位置包括用户级 ~/.qoder/AGENTS.md、项目级 <project>/AGENTS.md 和本地项目级 <project>/AGENTS.local.md。
• Rules：放在 <project>/.qoder/rules/ 下、按主题或文件范围拆分的 Markdown 规则文件，适合替代单个臃肿的 AGENTS.md。

你可以在项目中运行 /init 自动生成 AGENTS.md，或用 /memory 管理各级记忆文件。完整说明见 记忆。

项目说明是提供给模型的上下文，而不是强制策略。如果需要硬性阻止某类命令、工具或路径，请使用 权限与目录信任 或 钩子。

​

长期记忆

长期记忆是跨会话保留的信息。除了上面由团队维护的静态记忆（AGENTS.md、rules），Qoder CLI 还支持自动记忆：启用后，Qoder 会把从对话中学到的、后续仍有用的信息保存成本机的 Markdown 记忆文件，例如你的偏好、反馈、项目背景，以及外部参考资料的位置。 自动记忆的查看和管理入口：

• 在 /memory 面板中打开 auto-memory folder。
• 运行 /memory manage 管理自动保存的记忆主题文件。

自动记忆同样作为上下文提供给模型，帮助 Qoder 在新会话中延续之前积累的理解。详见 记忆。

​

三者如何协作

一次会话开始时，Qoder 会加载适用的项目说明和长期记忆，作为背景注入上下文；随着对话推进，对话上下文不断累积。三者共同构成 Qoder 做决策时依赖的完整背景：

• 对话上下文解决"这次会话里我们聊到哪了"。
• 项目说明解决"这个项目有哪些必须遵守的约定"。
• 长期记忆解决"跨会话都应该记住的偏好和背景是什么"。

想让某个知识长期生效，就把它写进项目说明或保存为长期记忆；只在当前任务里相关的临时信息，留在对话上下文里即可，必要时用 /clear 或 /compact 清理。