Zeus Agent 的存储架构设计，包括 Checkpoint（状态持久化）和 Backend（文件存储）两大核心组件。
架构概览
核心组件
| 组件 | 用途 | 存储位置 | 文档 |
|---|---|---|---|
| Checkpointer | Agent 状态持久化、HITL 中断恢复 | PostgreSQL | Checkpoint.md |
| Backend | 文件系统操作、用户云盘 | Supabase Storage | Backend.md |
| Memory | 长期记忆（自己实现） | Supabase Storage | Backend.md |
快速对比
| 对比项 | Checkpointer | Backend | Memory |
|---|---|---|---|
| 存储内容 | Agent 执行状态 | 文件/产物 | 用户知识/偏好 |
| 粒度 | 每步执行 | 文件操作 | 概念级 |
| 生命周期 | 会话级 | 用户级 | 永久 |
| 访问者 | LangGraph 内部 | Agent 工具 | 自定义逻辑 |
| 当前实现 | DrizzleCheckpointSaver | StateBackend | InMemoryStore |
| 目标实现 | PostgresSaver | CloudDriveBackend | Supabase Storage |
迁移优先级
- 高优先级：Checkpoint - 影响 HITL 功能稳定性
- 中优先级：Backend - 影响产物持久化和用户体验
- 低优先级：Redis 缓存 - 性能优化，可后续添加
环境变量
需要配置以下环境变量：DATABASE_URL- PostgreSQL 连接地址（用于 Checkpointer）SUPABASE_URL- Supabase Storage URL（用于 Backend）SUPABASE_SERVICE_KEY- Supabase Service Key（用于 Backend）REDIS_URL- Redis 连接地址（可选，用于缓存）