Skip to main content
Deep Agents CLI 将数据存储在两个目录层级中：
  • ~/.deepagents/ — Deep Agents 专用数据（智能体记忆、技能、会话）
  • ~/.agents/ — 工具无关数据（跨 AI CLI 工具共享的技能）

​
目录结构

[code block with directory tree - keep unchanged]

​
数据存储位置

数据位置读/写说明
会话~/.deepagents/sessions.dbR/WSQLite 检查点数据库
输入历史~/.deepagents/history.jsonlR/WJSON 行格式，支持上下箭头回调
基础指令包内 default_agent_prompt.mdR不可变，随 CLI 升级更新
用户自定义~/.deepagents/{agent}/AGENTS.mdR/W附加到基础指令
项目指令.deepagents/AGENTS.md 或 AGENTS.mdR如两者都存在则均加载
用户技能~/.deepagents/{agent}/skills/R/W智能体专用技能
共享技能~/.agents/skills/R工具无关，跨 CLI 共享
项目技能.deepagents/skills/ 或 .agents/skills/R项目范围
自定义子代理~/.deepagents/{agent}/agents/R/W用户定义的子代理
项目子代理.deepagents/agents/R项目定义的子代理

​
优先级规则

当同一项目存在于多个位置时，优先级更高的完全覆盖（不合并）。

​
技能

优先级顺序（从低到高）：
  1. ~/.deepagents/{agent}/skills/ — 用户 deepagents
  2. ~/.agents/skills/ — 用户工具无关
  3. .deepagents/skills/ — 项目 deepagents
  4. .agents/skills/ — 项目工具无关 （最高）

​
子代理

优先级顺序（从低到高）：
  1. ~/.deepagents/{agent}/agents/ — 用户级别
  2. .deepagents/agents/ — 项目级别 （最高）

​
指令

所有指令来源均合并（不覆盖）：
  1. 包基础提示词 （始终加载）
  2. ~/.deepagents/{agent}/AGENTS.md （附加）
  3. .deepagents/AGENTS.md （附加）
  4. 项目根目录的 AGENTS.md （附加）

​
.deepagents 与 .agents 的区别

目录用途使用场景
.deepagents/Deep Agents CLI 专用使用 CLI 特定功能的技能和配置
.agents/工具无关需要在不同 AI CLI 工具间共享的技能
对适用于任何 AI 编程助手的技能，使用 .agents/skills/。 对依赖 Deep Agents 特定工具或约定的技能，使用 .deepagents/skills/。

​
清理数据

需求操作
重置所有数据rm -rf ~/.deepagents
仅清除会话rm ~/.deepagents/sessions.db
清除输入历史rm ~/.deepagents/history.jsonl
重置智能体指令deepagents reset --agent {name}
删除某个技能rm -rf ~/.deepagents/{agent}/skills/{skill-name}
删除 ~/.deepagents/sessions.db 将移除所有对话历史和检查点。 此操作无法撤销。
在 GitHub 上编辑此页面 或提交问题。
连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。