数据位置

深度智能体 CLI 存储配置、会话和自定义文件的位置

深度智能体 CLI 将数据存储在两个目录层次结构中：

• ~/.deepagents/ — 深度智能体特定数据（智能体记忆、技能、会话）
• ~/.agents/ — 工具无关数据（跨 AI CLI 工具共享的技能）

目录结构

~/.deepagents/
├── .state/                  # 每台机器的 CLI 状态（自动管理）
│   ├── 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/.state/sessions.db	读/写	SQLite 检查点数据库
输入历史	~/.deepagents/.state/history.jsonl	读/写	JSON-lines，上下箭头回忆
基础指令	包内 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。

子智能体

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

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

每个子智能体是一个带有 YAML frontmatter（name、description、可选 model）和 markdown 正文作为系统提示的 AGENTS.md 文件。参见在 CLI 中使用子智能体获取完整格式参考。

指令

所有指令来源组合（不覆盖）：

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

.deepagents vs .agents

目录	用途	何时使用
.deepagents/	深度智能体 CLI 特定	使用 CLI 特定功能的技能和配置
.agents/	工具无关	你希望跨不同 AI CLI 工具共享的技能

使用 .agents/skills/ 放置可与任何 AI 编码助手一起使用的技能。 使用 .deepagents/skills/ 放置依赖深度智能体特定工具或约定的技能。

清理

需求	操作
重置所有数据	rm -rf ~/.deepagents
仅清除会话	rm ~/.deepagents/.state/sessions.db*
清除输入历史	rm ~/.deepagents/.state/history.jsonl
清除已存储的 API 密钥	rm ~/.deepagents/.state/auth.json
清除 MCP OAuth 令牌	rm -rf ~/.deepagents/.state/mcp-tokens
重新运行首次运行引导	rm ~/.deepagents/.state/onboarding_complete
重置智能体指令	deepagents agents reset --agent {name}
移除一个技能	rm -rf ~/.deepagents/{agent}/skills/{skill-name}

删除 ~/.deepagents/.state/sessions.db 将移除所有对话历史和检查点。

除非你有 sessions.db 文件的备份，否则无法撤销。

---

连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。

在 GitHub 上编辑此页面或提交问题。