核心模块
Bootstrapping
启动引导 — System Prompt 组装、模式选择、动态上下文注入
HITL
Auto-Run 模式与工具审批机制，确保 Agent 执行敏感操作前获得人类确认
Middleware
DeepAgents 中间件管线 — 自动摘要、文件系统、任务管理、提示词缓存等
Models
模型配置与管理 — 支持自有 API Key、Zeus 预置模型、200+ 模型 Profile
Context
Agent 上下文组装、Token 管理与优化策略
Tools
四层工具体系 — Built-in Tools、MCP Tools、OAuth Tools、Connector Tools
Skills
动态指令包 — 代码审查、数据分析、写作助手等可扩展技能
System Prompt
系统提示词 — CORE、SOUL、TOOLS、WORKFLOW、MEMORY、动态注入
Artifacts
结构化工具返回格式 — HTML、代码、图表等富内容渲染
Workspace
每个用户拥有独立的云端工作空间，由CloudDriveBackend 管理，底层使用 Supabase Storage 持久化，Redis 提供缓存层。
| 路径 | 说明 |
|---|---|
users/{user_id}/workspace/ | Agent 的工作目录，存放产出文件 |
users/{user_id}/workspace/projects/ | 项目文件 |
users/{user_id}/workspace/sandbox-output/ | 沙盒执行结果 |
users/{user_id}/workspace/uploads/ | 用户上传文件 |
users/{user_id}/memory/ | 长期记忆文件 |
文件系统详细设计
了解 CloudDriveBackend、Checkpoint 等存储架构的完整设计
Sessions
每个对话创建一个独立 Session，提供状态隔离：- Session ID：格式为
session_{hex12}，由前端提供或自动生成 - Thread ID：与 Session ID 一致，用于 Checkpointer 状态隔离
- Context Cache：按 session_id 存储工具列表、系统提示词、中断配置，供 HITL 恢复时复用
Checkpointer
状态持久化通过 LangGraph 的 Checkpointer 机制实现：| 环境 | 实现 | 说明 |
|---|---|---|
| 生产 | PostgresSaver | PostgreSQL 持久化，支持跨进程恢复 |
| 开发/回退 | MemorySaver | 内存存储，进程重启后丢失 |
Checkpoint 存储方案
了解 PostgresSaver 的详细配置与 HITL 恢复流程
Modes
Zeus 支持三种交互模式，每种模式限定了 Agent 的工具集和行为边界：模式对比
| 特性 | Agent | Ask | Plan |
|---|---|---|---|
| 文件读取 | 可 | 可 | 可 |
| 文件写入 | 可 | 不可 | 不可 |
| 沙盒执行 | 可 | 不可 | 不可 |
| 记忆读取 | 可 | 不可 | 可 |
| 记忆写入 | 可 | 不可 | 不可 |
| HITL 审批 | 可 | 不可 | 不可 |
| 工具调用 | 全部 | 只读子集 | 只读子集 |
| 典型场景 | 编码、部署、自动化 | 代码解读、问答 | 架构设计、方案对比 |
invoke() 入口处立即生效，通过禁用标志和工具过滤实现。Ask 模式禁用沙盒、记忆写入和 HITL；Plan 模式禁用沙盒和 HITL，但保留记忆读取以获取上下文。