> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 数据位置

> Deep Agents CLI 存储配置、会话和自定义文件的位置

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

* **`~/.deepagents/`** — Deep Agents 特定数据（代理记忆、技能、会话）
* **`~/.agents/`** — 工具无关数据（跨 AI CLI 工具共享的技能）

## 目录结构

```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
~/.deepagents/
├── sessions.db              # 用于对话检查点的 SQLite 数据库
├── history.jsonl            # 命令输入历史记录
└── {agent}/                 # 每个代理的目录（默认："agent"）
    ├── AGENTS.md            # 用户对代理指令的自定义
    ├── skills/              # 用户级技能
    │   └── {skill-name}/
    │       └── SKILL.md
    └── agents/              # 自定义子代理定义
        └── {subagent-name}/
            └── AGENTS.md

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

{project}/                   # 项目级（在 git 仓库根目录）
├── AGENTS.md                # 项目指令（根级）
└── .deepagents/
│   ├── AGENTS.md            # 项目指令（首选位置）
│   ├── skills/              # 项目特定技能
│   │   └── {skill-name}/
│   │       └── SKILL.md
│   └── agents/              # 项目特定子代理
│       └── {subagent-name}/
│           └── AGENTS.md
└── .agents/                 # 工具无关的项目技能
    └── skills/
        └── {skill-name}/
            └── SKILL.md
```

## 数据存放位置

| 数据         | 位置                                        | 读/写 | 备注                 |
| ---------- | ----------------------------------------- | --- | ------------------ |
| **会话**     | `~/.deepagents/sessions.db`               | 读/写 | SQLite 检查点数据库      |
| **输入历史**   | `~/.deepagents/history.jsonl`             | 读/写 | JSON 行格式，通过上/下箭头调用 |
| **基础指令**   | 包 `default_agent_prompt.md`               | 只读  | 不可变，随 CLI 升级更新     |
| **用户自定义**  | `~/.deepagents/{agent}/AGENTS.md`         | 读/写 | 追加到基础指令            |
| **项目指令**   | `.deepagents/AGENTS.md` 或 `AGENTS.md`     | 只读  | 如果存在，两者都会加载        |
| **用户技能**   | `~/.deepagents/{agent}/skills/`           | 读/写 | 代理特定技能             |
| **共享技能**   | `~/.agents/skills/`                       | 只读  | 工具无关，跨 CLI         |
| **项目技能**   | `.deepagents/skills/` 或 `.agents/skills/` | 只读  | 项目范围               |
| **自定义子代理** | `~/.deepagents/{agent}/agents/`           | 读/写 | 用户定义的子代理           |
| **项目子代理**  | `.deepagents/agents/`                     | 只读  | 项目定义的子代理           |

## 优先级规则

当同一项目存在于多个位置时，**高优先级完全胜出**（不合并）。

### 技能

优先级顺序（从低到高）：

1. `~/.deepagents/{agent}/skills/` — 用户 deepagents
2. `~/.agents/skills/` — 用户工具无关
3. `.deepagents/skills/` — 项目 deepagents
4. `.agents/skills/` — 项目工具无关 *（最高）*

加载技能时，CLI 会验证解析后的文件路径是否保持在这些目录之一内。解析到所有技能根目录之外的符号链接将被拒绝。要允许符号链接目标位于其他目录，请参阅 [`[skills].extra_allowed_dirs`](/oss/javascript/deepagents/cli/configuration#skills-extra-allowed-directories)。

### 子代理

优先级顺序（从低到高）：

1. `~/.deepagents/{agent}/agents/` — 用户级
2. `.deepagents/agents/` — 项目级 *（最高）*

每个子代理是一个带有 YAML frontmatter（`name`、`description`、可选 `model`）和用于系统提示的 markdown 正文的 `AGENTS.md` 文件。完整格式参考请参阅 [自定义子代理](/oss/javascript/deepagents/cli/overview#subagents)。

### 指令

所有指令源是**组合**的（而非覆盖）：

1. 包基础提示 *（始终加载）*
2. `~/.deepagents/{agent}/AGENTS.md` *（追加）*
3. `.deepagents/AGENTS.md` *（追加）*
4. 项目根目录的 `AGENTS.md` *（追加）*

## `.deepagents` 与 `.agents`

| 目录             | 用途                 | 何时使用                  |
| -------------- | ------------------ | --------------------- |
| `.deepagents/` | Deep Agents CLI 特定 | 使用 CLI 特定功能的技能和配置     |
| `.agents/`     | 工具无关               | 你希望跨不同 AI CLI 工具共享的技能 |

<Tip>
  对于可与任何 AI 编码助手配合使用的技能，请使用 `.agents/skills/`。
  对于依赖 Deep Agents 特定工具或约定的技能，请使用 `.deepagents/skills/`。
</Tip>

## 清理

| 需求     | 操作                                                 |
| ------ | -------------------------------------------------- |
| 重置所有数据 | `rm -rf ~/.deepagents`                             |
| 仅清除会话  | `rm ~/.deepagents/sessions.db`                     |
| 清除输入历史 | `rm ~/.deepagents/history.jsonl`                   |
| 重置代理指令 | `deepagents agents reset --agent {name}`           |
| 移除技能   | `rm -rf ~/.deepagents/{agent}/skills/{skill-name}` |

<Warning>
  删除 `~/.deepagents/sessions.db` 将移除所有对话历史和检查点。
  此操作无法撤销。
</Warning>

***

<div className="source-links">
  <Callout icon="terminal-2">
    [连接这些文档](/use-these-docs) 到 Claude、VSCode 等，通过 MCP 获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/deepagents/data-locations.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>