数据存储位置

为什么需要了解

你的 Agent 记住了什么、会话存在哪里、技能从哪加载——全都取决于数据存储位置

两级目录

Deep Agents Code 将数据存储在两个目录层级中

用户级结构

~/.deepagents/ 和 ~/.agents/ 的完整目录树

~/.deepagents/
├── .state/                  # 每台机器的状态（自动管理）
│   ├── sessions.db          #   会话检查点的 SQLite 数据库
│   ├── history.jsonl        #   命令输入历史
│   └── ...                  #   其他标记和凭证
└── {agent}/                 # 每个 Agent 的目录（默认："agent"）
    ├── AGENTS.md            # 用户对 Agent 指令的自定义
    ├── skills/              # 用户级技能
    │   └── {skill-name}/
    │       └── SKILL.md
    └── agents/              # 自定义子 Agent 定义
        └── {subagent-name}/
            └── AGENTS.md

~/.agents/                   # 工具无关别名（跨 AI CLI 共享）
└── skills/                  # 任何兼容工具都可使用的技能
    └── {skill-name}/
        └── SKILL.md

项目级结构

在 Git 仓库根目录下的配置目录——只对当前项目生效

{project}/                   # 项目级（位于 Git 仓库根目录）
├── AGENTS.md                # 项目指令（根目录级别）
└── .deepagents/
│   ├── AGENTS.md            # 项目指令（首选位置）
│   ├── skills/              # 项目专属技能
│   │   └── {skill-name}/
│   │       └── SKILL.md
│   └── agents/              # 项目专属子 Agent
│       └── {subagent-name}/
│           └── AGENTS.md
└── .agents/                 # 工具无关的项目技能
    └── skills/
        └── {skill-name}/
            └── SKILL.md

数据一览

每种数据存储在哪里、读/写权限如何——一张表看全貌

技能优先级

同名技能存在于多个位置时，优先级高的完全覆盖优先级低的（不合并）

子 Agent 与指令

子 Agent 覆盖规则 vs 指令叠加规则——两种完全不同的优先级机制

目录区别

.deepagents/ 与 .agents/ 的定位和使用场景

清理操作

按需清理特定数据——不同的需求对应不同的命令

# 安全清理示例——先备份会话数据库，再删除
$ cp ~/.deepagents/.state/sessions.db ~/sessions-backup.db
$ rm ~/.deepagents/.state/sessions.db

# 只想重新开始？删除引导标记即可，不影响其他数据
$ rm ~/.deepagents/.state/onboarding_complete
$ dcode  # 下次启动会自动重新进入首次引导流程

本章回顾

到这里，你已经掌握了 Deep Agents Code 数据存储的完整图景