deepagents-cli 相比 deepagents 的额外功能

1. 交互式 CLI 界面

• 终端交互界面（使用 prompt_toolkit）
• 实时显示工具调用和结果
• 彩色输出和格式化（使用 rich）
• 斜杠命令系统（/help, /tokens, /exit 等）

2. 自定义工具集

CLI 额外提供：

• web_search - 使用 Tavily API 进行网络搜索
• fetch_url - 获取网页并转换为 Markdown
• http_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 在核心库基础上增加了：

1. 完整的终端交互体验
2. 技能和记忆系统
3. 项目感知和配置管理
4. 远程沙箱集成
5. 增强的工具集（网络搜索、HTTP 请求等）
6. 开发体验优化（Token 跟踪、操作预览等）

核心库专注于代理框架和中间件，CLI 在此基础上提供面向终端用户的完整应用。