自动记忆
Agent 使用"记忆优先"协议——先查记忆再回答
在你使用 Agent 的过程中，它会自动将信息存储在 ~/.deepagents/<agent_name>/memories/ 中，以 Markdown 文件的形式保存。整个过程分三步：
1. 研究
在开始任务之前，先搜索记忆以获取相关上下文
2. 响应
在执行过程中不确定时，查阅已有记忆
3. 学习
自动保存新信息以供未来会话使用
# 记忆文件按主题组织，存储在 Agent 专属目录下
# 每个 .md 文件记录一类知识，Agent 根据任务自动检索
~/.deepagents/backend-dev/memories/
├── api-conventions.md # API 编码约定（命名、格式等）
├── database-schema.md # 数据库表结构和字段说明
└── deployment-process.md # 部署流程和注意事项教 Agent 一个约定
dcode --agent backend-dev
> Our API uses snake_case and includes \
created_at/updated_at timestampsAgent 自动记住
> Create a /users endpoint
# Agent 无需提示即可应用约定
# 自动使用 snake_case
# 自动添加 created_at/updated_at
记忆优先协议：Agent 在回答问题或执行任务之前，会先搜索记忆文件。这意味着你教过它一次的约定，它在所有未来的会话中都会自动遵循——不需要每次都提醒。
记忆原理
Agent 何时读取记忆、何时更新记忆
Agent 的记忆不是"只在启动时读一次"，而是在整个交互过程中持续运作：
何时读取
- 启动时：加载 AGENTS.md 到系统提示
- 回答项目特定问题时：搜索记忆文件
- 你引用过去的工作或模式时：查找相关记忆
何时更新
- 你提供行为指导时：更新 AGENTS.md
- 你给出工作反馈时：记住偏好
- Agent 识别出模式时：自动保存新记忆
- 你使用 /remember 时：显式触发更新
在 AGENTS.md 中引用额外文件
# AGENTS.md
## 项目架构
详细架构说明请参考 [架构文档](./architecture.md)
## API 约定
完整 API 规范请参考 [API 文档](./api-spec.md)额外文件不会被自动加载
.deepagents/
├── AGENTS.md ← 启动时自动加载到系统提示
├── architecture.md ← Agent 需要时才读取（需在 AGENTS.md 中引用）
├── api-spec.md ← Agent 需要时才读取（需在 AGENTS.md 中引用）
└── deployment.md ← Agent 需要时才读取（需在 AGENTS.md 中引用）
关键规则：额外的记忆文件不会在启动时读取，但 Agent 可以在需要时引用和更新它们。你必须在 AGENTS.md 中引用额外文件，Agent 才能感知到它们的存在。
全局与项目
什么时候用全局 AGENTS.md，什么时候用项目级
全局 AGENTS.md
~/.deepagents/agent/AGENTS.md
- 你的个性、风格和通用编码偏好
- 总体的语气和沟通风格
- 通用编码偏好（格式化、类型提示等）
- 适用于所有场景的工具使用模式
- 不随项目变化的工作流和方法论
项目 AGENTS.md
.deepagents/AGENTS.md
- 项目特定的上下文和约定
- 项目架构和设计模式
- 特定于该代码库的编码约定
- 测试策略和部署流程
- 团队指南和项目结构
# 文件结构示例
~/.deepagents/ # 用户级配置根目录
└── backend-dev/ # 以 Agent 名称命名的专属目录
├── AGENTS.md # 全局：编码风格、偏好（所有项目通用）
└── memories/
├── api-conventions.md # 自动保存的 API 约定记忆
└── database-schema.md # 自动保存的数据库结构记忆
my-project/ # 项目根目录
├── .deepagents/
│ └── AGENTS.md # 项目级：架构、约定（仅本项目加载）
├── src/
└── .git/ # Git 仓库是项目级配置被发现的条件
最佳实践：全局 AGENTS.md 写"你是谁"（风格、偏好、方法论），项目 AGENTS.md 写"这个项目怎么做"（架构、约定、流程）。两者在启动时合并加载到系统提示中。