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

# Qoder CLI 如何记住信息

<div id="overview">
  # 概述
</div>

Qoder CLI 每次会话都会**重新构造上下文**——它不会自动记得上一次会话聊过什么，除非这些信息被显式保存下来。理解 Qoder 记住信息的几种机制，能帮助你把该长期保留的知识固化下来，同时避免让无关内容占满上下文。

Qoder 依赖的信息主要来自三个层面，它们的生命周期和用途各不相同：

| 层面    | 生命周期   | 谁维护           | 典型内容              |
| :---- | :----- | :------------ | :---------------- |
| 对话上下文 | 当前会话内  | Qoder 自动累积    | 历史消息、工具调用、结果      |
| 项目说明  | 长期，随项目 | 你或团队          | `AGENTS.md`、rules |
| 长期记忆  | 长期，跨会话 | 团队约定 + 可选自动记忆 | 偏好、项目背景、外部资料位置    |

<div id="conversation-context">
  # 对话上下文
</div>

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

对话上下文有几个关键特点：

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

## 管理对话上下文

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

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

<div id="project-instructions">
  # 项目说明
</div>

项目说明是由你或团队**显式编写**的静态记忆，用来告诉 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` 管理各级记忆文件。完整说明见 [记忆](/zh/cli/04-扩展QoderCLI/memory)。

> 项目说明是提供给模型的上下文，而不是强制策略。如果需要**硬性**阻止某类命令、工具或路径，请使用 [权限](/zh/cli/06-配置与安全/permissions) 或 [Hooks](/zh/cli/04-扩展QoderCLI/hooks)。

<div id="long-term-memory">
  # 长期记忆
</div>

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

自动记忆的查看和管理入口：

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

自动记忆同样作为上下文提供给模型，帮助 Qoder 在新会话中延续之前积累的理解。详见 [记忆](/zh/cli/04-扩展QoderCLI/memory)。

<div id="how-they-work-together">
  # 三者如何协作
</div>

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

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

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