deepagents-cli相比deepagents的额外功能
1. 交互式 CLI 界面
- 终端交互界面（使用
prompt_toolkit） - 实时显示工具调用和结果
- 彩色输出和格式化（使用
rich） - 斜杠命令系统（
/help,/tokens,/exit等）
2. 自定义工具集
CLI 额外提供：
web_search- 使用 Tavily API 进行网络搜索fetch_url- 获取网页并转换为 Markdownhttp_request- 通用 HTTP 请求工具shell- 本地 shell 命令执行（非沙箱模式）
核心库仅提供基础文件系统工具。
3. 技能系统（Skills System）
- 渐进式技能加载（Progressive Disclosure）
- 技能目录管理（全局 + 项目级）
- 技能命令：
deepagents skills list/create/info - 自动技能发现和加载
- 技能中间件（
SkillsMiddleware）
核心库不包含技能系统。
4. 持久化记忆系统（Agent Memory）
- 用户级记忆：
~/.deepagents/{agent}/agent.md - 项目级记忆：
.deepagents/agent.md - 自动记忆加载和注入
- 记忆更新指令（何时读取/更新）
- 结构化项目记忆文件（如
architecture.md,deployment.md） - 记忆中间件（
AgentMemoryMiddleware）
核心库不包含持久化记忆。
5. 项目感知功能
- 自动检测项目根目录（通过
.git） - 加载项目特定配置
- 项目级技能覆盖全局技能
- 项目记忆与用户记忆合并
核心库不包含项目感知。
6. 远程沙箱集成
- Modal 沙箱集成
- Runloop 沙箱集成
- Daytona 沙箱集成
- 沙箱工厂模式（统一接口）
- 沙箱设置脚本支持
核心库仅提供后端协议，不包含具体集成。
7. 文件操作跟踪和 HITL
- 文件操作预览和差异显示
- 人工审批流程（HITL）
- 操作记录和指标跟踪
- 文件操作历史
核心库的 HITL 需要手动配置。
8. Token 使用跟踪
- 实时 Token 计数
- 基线 Token 计算（包含系统提示和记忆）
- Token 使用统计显示
核心库不包含 Token 跟踪。
9. 图像支持
- 图像输入处理（
ImageTracker） - 图像文件路径解析
- 多模态输入支持
核心库不包含图像处理。
10. 代理管理命令
deepagents list# 列出所有代理deepagents reset --agent xxx# 重置代理deepagents --agent mybot# 使用特定代理核心库不包含代理管理。
11. 配置和环境管理
.env文件支持- 自动 API Key 检测和验证
- 模型自动选择（Anthropic/OpenAI）
- 设置管理（
Settings类）
核心库需要手动配置。
12. 执行流程增强
- 任务执行包装（
execute_task） - 文件提及解析（
parse_file_mentions） - 上下文注入
- 错误处理和显示
13. UI 组件
TokenTracker- Token 使用跟踪show_help- 帮助信息显示- 启动画面（ASCII 艺术）
- 彩色输出和格式化
功能对比表
| 功能 | deepagents核心库 | deepagents-cli |
|---|---|---|
| 基础代理创建 | ✅ | ✅ |
| 文件系统工具 | ✅ | ✅ |
| 子代理委托 | ✅ | ✅ |
| 任务列表 | ✅ | ✅ |
| CLI 界面 | ❌ | ✅ |
| 网络搜索 | ❌ | ✅ |
| 技能系统 | ❌ | ✅ |
| 持久化记忆 | ❌ | ✅ |
| 项目感知 | ❌ | ✅ |
| 远程沙箱集成 | ❌ | ✅ |
| Token 跟踪 | ❌ | ✅ |
| 图像支持 | ❌ | ✅ |
| 代理管理 | ❌ | ✅ |
| HITL 预览 | 基础 | 增强 |
总结
deepagents-cli在核心库基础上增加了：
- 完整的终端交互体验
- 技能和记忆系统
- 项目感知和配置管理
- 远程沙箱集成
- 增强的工具集（网络搜索、HTTP 请求等）
- 开发体验优化（Token 跟踪、操作预览等）
核心库专注于代理框架和中间件，CLI 在此基础上提供面向终端用户的完整应用。
