文件系统 - Zeus

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 连接地址（可选，用于缓存）