DeepAgents Backend 用于管理 Agent 的文件系统操作，包括产物存储、用户云盘和长期记忆。
1. 概述
1.1 当前问题
1.2 目标
- 所有产物自动持久化到云存储
- 用户拥有”云盘”体验，随时访问自己的文件
- 统一存储架构，减少复杂度
2. DeepAgents Backend 类型
DeepAgents 提供以下 Backend 类型：3. 推荐方案：CloudDriveBackend
3.1 架构设计
3.2 存储结构
4. CloudDriveBackend 概述
CloudDriveBackend 是基于 Supabase Storage 的持久化文件后端，具有以下特点：- 每个用户隔离的存储空间
- 所有文件自动持久化
- Redis 缓存加速
- 支持大文件（图片、文档等）
/workspace/- 工作区文件（Agent 产物）/memory/- 长期记忆（用户知识）
- 虚拟路径
/code/main.py映射到users/{user_id}/workspace/code/main.py - 虚拟路径
/memory/facts.json映射到users/{user_id}/memory/facts.json
4.1 集成方式
BaseService 通过 Redis 缓存和用户级 Backend 缓存管理 CloudDriveBackend 实例。每个用户拥有独立的 Backend 实例，通过get_backend(user_id) 获取。
5. Desktop 模式支持
当用户使用 Desktop 应用时，系统会根据设备类型自动选择合适的 Backend：- Desktop 模式：使用 FilesystemBackend（本地文件系统）
- Cloud 模式：使用 CloudDriveBackend（Supabase Storage）
6. 前端云盘 API
前端通过以下 API 接口与云盘交互：GET /api/storage/list?path=...- 列出文件POST /api/storage/upload- 上传文件GET /api/storage/download?path=...- 下载文件DELETE /api/storage/delete?path=...- 删除文件GET /api/storage/url?path=...- 获取预览 URL
7. 沙盒产物同步
当 E2B 沙盒生成文件后，系统会自动将产物同步到用户云盘，存储在/workspace/sandbox-output/{date}/ 路径下。
8. 性能优化
8.1 Redis 缓存效果
8.2 缓存策略
- 工作区文件 TTL: 5 分钟
- 记忆文件 TTL: 10 分钟
- 写入/编辑后立即更新缓存
9. 迁移步骤
- 创建 Supabase Storage Bucket - 在 Supabase Dashboard 中创建
workspacebucket - 配置 RLS 策略 - 确保用户只能访问自己的文件
- 配置环境变量 - 设置
SUPABASE_URL、SUPABASE_SERVICE_KEY、REDIS_URL（可选） - 创建 CloudDriveBackend - 实现 Backend 核心逻辑
- 修改 BaseService - 集成 CloudDriveBackend
- 删除旧代码 - 移除 StateBackend 和 InMemoryStore 相关使用