Rivet 3 + Pi Durable + OpenSandbox

当前倾向组合：Harness 与 Sandbox 分离产品控制面包含独立的 Runtime API，发起和终止交给 Session / Run，查询连接会话与执行状态。当前倾向 Rivet 3 + Pi Durable + OpenSandbox，NAS 保存视频产物；durable-harness + PG 与 celld 保留对照，运行表现待 POC。产品控制面 · 自建定义与发布 / Runtime API / 租户与配额Agent 运行 · Rivet 3Pi Durable + Actor SQLite沙箱服务 · CI + OpenSandboxCI 构建 / 沙箱管理与执行基础设施与外部服务发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置日志 / 对象桶模型 / API 调用UI / API / 消息 / Webhook在线 / 批量 / Agent 发起Agent 托管控制面定义与发布 + Runtime APIAgent 定义与发布model / tools / skills / 版本Environment 定义image / CPU / 内存 / readyWorkspace 模板与绑定初始文件树 / NAS 目录 / 产物Agent Runtime API发起 / 查询 / 终止Trigger / Cron / 批量派发Rivet Schedule / 自建批量入口Session / Run / subagentRivet Actor / Pi 会话服务端 HarnessPi Durable · 服务端运行会话与执行状态Actor SQLite · WarpDrive环境构建任务打包工具 / Skill / 初始模板沙箱管理服务创建 / 热池 / 回收工具沙箱实例 × Nread / write / edit / bash模型 / 可信 API模型供应商 / 内部 APINAS · 工作文件与产物独立目录 / 产物保留镜像仓库ACR · 镜像版本Rivet 存储依赖ESSD / S3 兼容桶
UI / API / 消息 / Webhook三类入口共用 Agent 运行底座；批量提交一组独立 Agent，subagent 由父 Agent 派发，不预设 Workflow。
Agent 托管控制面提供声明式定义与发布，以及发起、查询、终止接口。执行命令按 key 交给 Rivet Actor / Pi；配置与版本由产品控制面保存，会话状态与事件从 Actor 查询。durable-harness + PG 保留对照。
Agent 定义与发布自有项目契约，参考 eve 的声明式开发体验。定义、发布和业务配额由我们补齐；Pi 持久化与恢复队列复用已有框架。
Environment 定义自有环境契约，先构建和校验，再生成不可变环境版本。系统依赖与 Agent 提示词、Skills 分开管理。
Workspace 模板与绑定定义初始文件树与 NAS 数据卷。后台任务以完成后保留产物为主；Pool 模板可预挂 PVC。按 Pod 预绑定目录及 run→sandbox→目录映射需我们适配，目录可见范围和 RuntimeClass 兼容需 ACK 实测。
Agent Runtime API控制面内的运行时接口，发起和终止命令交给 Session / Run 与 Pi；查询状态、进度和输出事件关联会话与执行状态。终止当前执行仍保留已持久化会话和工作文件。
Trigger / Cron / 批量派发Rivet 提供定时与队列原语；批量入口按业务配额派发独立 Actor key。业务 Cron 配置、并发额度、父子关系与结果汇总仍需接入，批量任务仍是一组独立 Agent。
Session / Run / subagentRivet 按 key 管理 Actor 的路由、激活和休眠；每个 Actor 可容纳多个 Pi Conversation。独立子 Agent 采用独立 key，父子派发已有示例；业务汇总、配额和终止传播策略需接入验证。
服务端 HarnessPi Durable 在 Rivet 计算 Worker 内运行，使用 Actor SQLite 保存会话与任务检查点；模型可自配，文件和命令统一经 provider / ExecutionEnv 进入 OpenSandbox。SDK 与 provider 适配属于正常开发。
会话与执行状态Pi 会话保存在 Actor SQLite；Rivet Engine / WarpDrive 负责日志复制和持久化，近期写入先在 Engine 磁盘确认，再后台下沉对象桶。NAS 视频与产物独立保存；对象桶兼容及运行稳定性需实测。
环境构建任务发布阶段将重工具依赖、Skill 文件和初始模板打包为版本化镜像，推送镜像仓库；不在每次执行时重装依赖。
沙箱管理服务接收环境规格、挂载和热池配置，准备执行实例。首次文件或命令工具调用时领取，任务结束后释放或销毁，并补充预热容量；普通 K8s Pool 须提前挂卷。
工具沙箱实例 × N统一在沙箱内执行文件读写和命令，访问同一份挂载目录，无独立虚拟 FS 或文件同步层。隔离运行时作为环境配置；每任务使用独立目录，目录映射、挂载兼容和产物保留需实测。
模型 / 可信 API复用现有模型与 API。模型选择、调用凭证和限额由平台配置；本轮不新增模型网关选型。
NAS · 工作文件与产物已支持：普通 K8s PVC/subPath 与 Pool 模板静态预挂载。候选：subPathExpr 按 Pod UID 在预热时选目录，领取时绑定 run，完成后保留产物并销毁 Pod。该组合需适配与 ACK 实测；共享 PVC 不随任务删除，不能用 cwd 充当目录隔离。
镜像仓库使用独立镜像仓库保存构建产物；环境发版时构建并推送，执行实例在预热或创建时拉取。
Rivet 存储依赖Rivet Engine 使用各实例独立 ESSD 保存日志与身份，并将数据后台下沉到对象桶。对象桶兼容与恢复需实测；配置存储归产品控制面，Agent 会话无需 PG World。
在线 Agent
连续对话、流式输出、会话重连。
后台 / 批量 Agent
一任务一会话，按配额并发；读取大视频，完成后保留产物。
subagent
父 Agent 按需派发子任务，独立执行并汇总结果。

架构与职责

Agent 托管基座：职责与选型考虑保留产品控制面和 Agent 运行服务；沙箱服务包含环境构建任务、沙箱管理服务、工具沙箱实例。镜像仓库和持久文件存储作为外部资源，全部文件与命令统一通过沙箱执行。产品控制面定义 / 发布 / 运行管理Agent 运行服务会话调度 / Harness / 状态沙箱服务构建 / 生命周期 / 执行基础设施与外部服务发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置会话 / 状态配置 / 版本模型 / API 调用UI / API / 消息 / Webhook作用：接收请求与外部事件考虑：入口协议 / 流式连接Agent 托管控制面作用：管理定义、发布与运行考虑：权限 / 版本 / 配额Agent 定义与发布作用：配置模型、工具与技能考虑：定义格式 / 扩展接口Environment 定义作用：定义工具运行环境考虑：镜像 / 规格 / 就绪条件Workspace 模板与绑定作用：定义与绑定初始目录考虑：初始树 / 挂载 / 产物Agent Runtime API作用：发起、查询和终止执行考虑：调用契约 / 状态语义Trigger / Cron / 批量派发作用：按时间或批量派发任务考虑：Cron / 并发配额 / 排队Session / Run / subagent作用：管理会话、执行与子任务考虑：父子关系 / 并发 / 恢复服务端 Harness作用：模型循环与工具编排考虑：扩展 API / 上下文管理会话与执行状态作用：保留进度与执行记录考虑：恢复 / 故障接管 / 迁移环境构建任务作用：打包工具、Skill 与初始模板考虑：环境版本 / 依赖 / 构建缓存沙箱管理服务作用：创建、分配与回收执行实例考虑：环境配置 / 挂载 / 热池工具沙箱实例 × N作用：统一执行文件读写和命令考虑：工具接口 / 超时 / 隔离方式模型 / 可信 API作用：提供推理和外部能力考虑：接口 / 凭证 / 调用配额持久文件存储作用：保存工作文件与产物考虑：挂载 / 吞吐 / 目录隔离镜像仓库作用：保存版本化环境镜像考虑：版本 / 拉取 / 缓存会话与配置存储作用：保存会话、配置与版本考虑：持久化 / 备份 / 恢复
UI / API / 消息 / Webhook作用：接收请求与外部事件。选型考虑：入口协议 / 流式连接。
Agent 托管控制面作用：管理定义、发布与运行。选型考虑：权限 / 版本 / 配额。
Agent 定义与发布作用：配置模型、工具与技能。选型考虑：定义格式 / 扩展接口。
Environment 定义作用：定义工具运行环境。选型考虑：镜像 / 规格 / 就绪条件。
Workspace 模板与绑定作用：定义与绑定初始目录。选型考虑：初始树 / 挂载 / 产物。
Agent Runtime API作用：发起、查询和终止执行。选型考虑：调用契约 / 状态语义。
Trigger / Cron / 批量派发作用：按时间或批量派发任务。选型考虑：Cron / 并发配额 / 排队。
Session / Run / subagent作用：管理会话、执行与子任务。选型考虑：父子关系 / 并发 / 恢复。
服务端 Harness作用：模型循环与工具编排。选型考虑：扩展 API / 上下文管理。
会话与执行状态作用：保留进度与执行记录。选型考虑：恢复 / 故障接管 / 迁移。
环境构建任务作用：打包工具、Skill 与初始模板。选型考虑：环境版本 / 依赖 / 构建缓存。
沙箱管理服务作用：创建、分配与回收执行实例。选型考虑：环境配置 / 挂载 / 热池。
工具沙箱实例 × N作用：统一执行文件读写和命令。选型考虑：工具接口 / 超时 / 隔离方式。
模型 / 可信 API作用：提供推理和外部能力。选型考虑：接口 / 凭证 / 调用配额。
持久文件存储作用：保存工作文件与产物。选型考虑：挂载 / 吞吐 / 目录隔离。
镜像仓库作用：保存版本化环境镜像。选型考虑：版本 / 拉取 / 缓存。
会话与配置存储作用：保存会话、配置与版本。选型考虑：持久化 / 备份 / 恢复。

为什么把 Harness 放在服务端

完整 Pi Pod 与服务端 Harness 的架构对照完整 Pi Pod 的 Harness 和工具共用生命周期；服务端 Harness 与工具沙箱、外置会话分别替换，减少启动等待并支持分别恢复。每个 Pod 运行完整 Pi服务端 Harness + 工具沙箱本地调用远程工具 API文件文件Pi Harness · 模型 / API每个 Agent 随完整 Pod 启动bash / ffmpeg / 浏览器与 Harness 共用 Pod 的生命周期外置会话 / Workspace可用持久卷或数据库会话可恢复；计算仍随 Pod 启动服务端 Pi Durable先执行模型与 API；按需连接工具独立工具沙箱 · OpenSandbox首次文件或命令调用时领取；可单独重建PG Session 日志 + NAS Workspace会话与工具文件分别持久化Harness 重启读日志；产物保留在 NAS启动先启动完整环境模型 / API 可先跑；沙箱按需领取故障Pod 重启后恢复 Agent沙箱 / Harness 可分别替换与恢复凭证需另做凭证与工具隔离模型 / 平台凭证可留在沙箱外代价本地调用直接，接入简单需远程工具接口与 Workspace 绑定
Pi Harness · 模型 / API完整 Pi 在 Pod 中运行，文件和工具可以直接本地调用。会话仍可外置持久化；Pod 故障不必然丢会话，但需要重启完整 Agent 环境。
bash / ffmpeg / 浏览器业务也可以额外隔离工具和凭证；本图比较的是把完整 Pi 与工具环境放在同一 Pod 的基本部署方式，不把所有安全缺陷视为必然结果。
外置会话 / Workspace外置会话与工作文件也适用于完整 Pi Pod 路线。因此两种架构的区别不只是是否持久化，而是 Harness 与工具能否独立启动、替换和扩容。
服务端 Pi Durable借鉴 Anthropic 将 brain、hands、session 分离。我们用 durable-harness + Pi Durable 实现服务端 Harness；模型和可信 API 不必等待工具沙箱创建，多个 Agent 可独立启动。
独立工具沙箱 · OpenSandbox沙箱作为远程工具环境。工具失败反馈给 Agent，再决定重试或重建；沙箱可从已预挂 NAS 的热池领取。模型和平台凭证可留在沙箱外，具体权限仍需接入。
PG Session 日志 + NAS Workspace服务端 Harness 故障后由新实例读取日志接续；工具工作文件单独保留。这是本任务的候选组合，不是宣称 Anthropic 底层使用 PG 或 NAS；实际恢复和工具接入仍需 POC。
Anthropic · Managed Agents

筛选逻辑

开源自部署筛选与当前候选先筛选关键路径能否开源自部署。Agent 运行当前倾向 Rivet 3 + Pi Durable；durable-harness + PG 与 celld 保留对照。首期以一次性后台 Agent、冷启动与热池为重点，选择 OpenSandbox 普通 K8s 与 NAS/PVC 预挂载；暂停恢复降权，内存恢复和分支文件系统作为后续增强。否是Agent 运行Workspace优先否增强是关键路径开源且可独立部署？闭源托管 · 仅参考Claude Managed AgentsRivet 3 · 当前倾向durable-harness + PGcelld · DO + SQLite首期：冷启动 / 热池暂停 / 恢复降权首期需要分支文件系统？OpenSandbox + ACK普通 K8s · 热池 / NAS 预挂载暂停 / 内存恢复 · 后续增强Fast Sandbox / SubstrateNAS / PVC大视频 / 产物；scratch 本地LayerFS · 后续试验Workspace 分叉 / 合并

Agent 运行底座

两边都用 Pi，差别是底座替我们管理什么

相同 Pi Durable，两种 Session 管理方式Rivet 管理按 key 寻址的 Actor；pi-world 把 Pi Session 映射为持久 World run。两边都有 Pi 检查点与恢复，World run 不等于一次业务 Agent 执行。Rivet · 实体的位置与生命周期durable-harness + PG · 日志与队列路由 / 唤醒请求 / 投递打开 Harness打开 HarnessStorage 适配Storage 适配Actor key · 持久身份按 key 找到同一个 Agent 实体sessionId · 持久身份Pi Session 映射为 World runRivet · 路由 / 激活 / 生命周期把请求送到活跃 Actor空闲休眠；请求或定时任务唤醒World · 日志 / 队列 / 写入者接管HTTP 或队列触发 Worker 重开 Session写入冲突 fencing；后台队列恢复未完成执行Pi Durable · 相同的 Harness模型循环 / 工具 / 检查点 / 恢复一个 Actor 可容纳多个 ConversationPi Durable · 相同的 Harness模型循环 / 工具 / 检查点 / 恢复一个 Session 可继续多轮执行每 Actor SQLite → Engine / 对象桶Pi 任务状态与业务表可共存计算 Worker 与存储 Engine 分别伸缩World 事件日志 → 托管 PGPi commit 写入日志；重开时回放多个 Worker 共享日志与队列World run 是 Pi Session 的日志容器，≠ 一次 Agent 执行；两边都可一个会话持续多轮。
比较什么Rivet 3 · 当前倾向durable-harness + PGcelld
Pi 与恢复Pi Durable + Actor SQLite
模型、工具和任务检查点由 Pi 管理		Pi Durable + World Storage
模型、工具和任务检查点由 Pi 管理		同样可接 Pi Durable
当前集成与生命周期需验证
Session 身份Actor key → Agent 实体
内部可有多个 Conversation		sessionId → World run
可包含多轮 Agent 执行		Cell 名称 → DO 实体
会话如何映射由接入层决定
路由与并发Rivet 路由到活跃 Actor
Pi 控制对话排队 / steer / reject		HTTP / 队列找到 Session
Storage fencing 限定写入者		按名寻址 Cell
Pi 的并发接入需验证
空闲与唤醒Actor 自动休眠与唤醒
Worker / Engine 集群仍需运行		Session 可关闭后重开
Node Worker 常驻；队列负责再投递		Cell 按请求激活
节点与恢复协议需自管
实时交互已有事件订阅、Steer / Abort
WebSocket 休眠仍为 Beta		已有 SSE、重连与 Steer
终止、消息控制不必从零实现		沿用 DO 接口
Pi 控制与流式行为需验证
批量与 subagent独立 key / 子 Actor；已有示例
父子策略与配额仍由我们定义		独立 Session；队列派发
父子关系、汇总与配额由我们补齐		独立子 Cell
派发、汇总与 Pi 接入需补齐
状态与扩容每 Actor SQLite；Worker / Engine 分离
加节点不消除单热点 Actor 瓶颈		集中 PG 日志与队列
加 Worker 不直接增加 PG 写容量		每 Cell SQLite + 节点盘 / 桶
扩容依赖所有权与复制协议
维护与取舍Worker + Engine + 持久盘 + CAS 桶
当前倾向：实体管理完整；Preview 需验		服务 + 托管 PG
运行层仍为 Beta；PG World 待实测		celld 节点 + 持久盘 + CAS 桶
组件少；兼容与恢复仍需验
pi-world：Session 与日志 Pi 接入 / Steer Rivet 会话生命周期 Rivet Pi / 恢复

三种运行底座在 ACK 上的部署差异

Rivet 3 + Pi Durable

当前倾向：复用 Rivet 的 Actor 与 Pi 集成；我们维护 Worker、Engine、独立块盘和对象桶。

Rivet 3 + Pi Durable：ACK 中的 Agent 运行组件只比较 Agent 计算、运行时和持久存储的部署差异。沙箱作为共享外部接口；普通安装配置不作为阻塞。ACK · 我们部署的 Agent 运行组件工具 APISQLite 页 / 提交磁盘副本后台下沉阿里云 ALB统一任务 API / SSE / 长连接入口计算 Worker Pod · Node.js + RivetKitDeployment ×N · Pi 与原生 SQLite 在应用进程内Actor A · Pi Durable + SQLite AActor B · Pi Durable + SQLite B每个 Actor 独立状态；页面读写交给 EngineWorker 计算与 Engine 存储分别伸缩统一沙箱服务 · 后端另选首次文件 / 命令调用时领取任务结束释放；详见沙箱后端Rivet Engine 3 · StatefulSet ×3Actor 分配与路由 · WarpDrive 日志复制与持久化Engine 与计算 Worker 分开部署；3.0 不依赖 PG / NATS当前 Preview；升级与备份恢复需验证阿里云 ESSD · Engine 持久盘每个 Engine 独立 PVC；RWO；按官方要求配置盘容量保留副本与尚未下沉的数据，不能当作可丢缓存对象桶 · S3 兼容接口需要条件写 CAS / RangeOSS 缺所需 CAS；TOS 待实测
阿里云 ALB三种方案共用的业务入口；部署建议使用 ALB Ingress，运行底座内部接口不直接暴露公网。
计算 Worker Pod · Node.js + RivetKit每个 Actor 有独立 SQLite，多个 Actor 共享 Node.js Worker。SQLite 页读写通过 VFS 交给 Engine / WarpDrive；工具进程运行在外部沙箱服务。计算 Worker 和 Engine 分别扩容。
统一沙箱服务 · 后端另选只表示三种 Agent 运行底座都需要外接文件和命令执行环境。本图不重复展开沙箱控制面、节点、热池与 NAS；相关差异在沙箱后端章节比较。
Rivet Engine 3 · StatefulSet ×3Engine 使用多数磁盘副本确认提交，再后台下沉对象桶；磁盘上可能保留尚未下沉的已确认数据。当前版本升级需维护窗口，备份桶恢复到全新集群官方尚未验证。
阿里云 ESSD · Engine 持久盘按官方块盘要求映射 ESSD；每 Engine 至少 100 GiB 的生产建议需结合规格核验。盘和实例身份绑定，不能改用多实例共享 NAS。
对象桶 · S3 兼容接口两种运行时都需要满足其对象存储协议；不能只凭 S3-compatible 名称认定兼容。OSS 缺少所需条件写；TOS CAS、寻址、Range 与恢复语义需按锁定版本验证。

durable-harness + Pi Durable + 托管 PG

Pi Durable 运行 Agent；durable-harness 接入日志与恢复，PG World 连接托管 PG。

durable-harness + Pi Durable + 托管 PG：ACK 中的 Agent 运行组件只比较 Agent 计算、运行时和持久存储的部署差异。沙箱作为共享外部接口；普通安装配置不作为阻塞。ACK · 我们部署的 Agent 运行组件工具 API会话日志 / 队列阿里云 ALB统一任务 API / SSE / 长连接入口Agent Server Pod · Deployment ×NNode.js 进程 · 下列模块均随 Agent Server 一起部署Session APi Durable · Harness模型循环 / 上下文 / 工具编排Session BPi Durable · Harness模型循环 / 上下文 / 工具编排durable-harness · 日志与恢复接入openWorldStorage / resumeWithPG World · Agent Server 进程内库World 日志存储接口 / Graphile Worker 队列统一沙箱服务 · 后端另选首次文件 / 命令调用时领取任务结束释放；详见沙箱后端RDS PostgreSQL · 持久化 + 队列保存 World 会话事件、执行记录与任务队列我们配置数据库、迁移与容量；数据库底座由云侧托管
阿里云 ALB三种方案共用的业务入口；部署建议使用 ALB Ingress，运行底座内部接口不直接暴露公网。
Agent Server Pod · Deployment ×N每个会话由 Pi Durable Harness 执行模型循环、上下文管理与工具编排；durable-harness 提供 World 存储和会话恢复接入，PG World 负责日志接口及队列消费。三个软件层均在同一 Agent Server 进程内，多副本共享托管 PostgreSQL。OpenSandbox ExecutionEnv 仍需接入，PG 并发和故障接管需 POC。
统一沙箱服务 · 后端另选只表示三种 Agent 运行底座都需要外接文件和命令执行环境。本图不重复展开沙箱控制面、节点、热池与 NAS；相关差异在沙箱后端章节比较。
RDS PostgreSQL · 持久化 + 队列RDS PG 是该方案的 Agent 状态与队列依赖，不只是业务配置库。PG World 官方仍定位为参考实现；PG 压力、多 Pod 接管和长会话恢复需实测。

celld + Pi Durable

每节点部署 celld 进程，同时承载 Cell 与存储协议；需要本地状态盘和满足 CAS 的对象桶。

celld + Pi Durable：ACK 中的 Agent 运行组件只比较 Agent 计算、运行时和持久存储的部署差异。沙箱作为共享外部接口；普通安装配置不作为阻塞。ACK · 我们部署的 Agent 运行组件工具 APISQLite / 日志复制 / 上传阿里云 ALB统一任务 API / SSE / 长连接入口celld Pod ×N · Rust 二进制每节点承载多个 Cell；Pi Durable 接入需验证Cell A · Pi Durable + SQLite ACell B · Pi Durable + SQLite B每个 Cell 独立状态；执行与存储协议在同一节点我们部署 celld 节点并保留其本地状态盘统一沙箱服务 · 后端另选首次文件 / 命令调用时领取任务结束释放；详见沙箱后端阿里云 ESSD · celld 节点状态盘每个节点独立持久目录；保存 SQLite / 复制日志磁盘恢复与节点接管按 celld 协议实测对象桶 · S3 兼容接口需要条件写 CAS / RangeOSS 缺所需 CAS；TOS 待实测
阿里云 ALB三种方案共用的业务入口；部署建议使用 ALB Ingress，运行底座内部接口不直接暴露公网。
celld Pod ×N · Rust 二进制同一 celld 节点运行多个 Cell，每个 Cell 独立 SQLite。执行与存储协议位于同一个节点进程，不需要额外部署 Rivet Engine。Pi 示例升级与工具适配是正常开发；对象桶协议、节点故障和本地盘恢复需 POC。
统一沙箱服务 · 后端另选只表示三种 Agent 运行底座都需要外接文件和命令执行环境。本图不重复展开沙箱控制面、节点、热池与 NAS；相关差异在沙箱后端章节比较。
阿里云 ESSD · celld 节点状态盘celld 外部服务依赖少不代表本地盘可任意丢弃。使用独立持久盘并验证节点恢复、日志复制与对象桶接管；不是 NAS 工作文件盘。
对象桶 · S3 兼容接口两种运行时都需要满足其对象存储协议；不能只凭 S3-compatible 名称认定兼容。OSS 缺少所需条件写；TOS CAS、寻址、Range 与恢复语义需按锁定版本验证。
durable-harness 自托管 Rivet 3 自托管 Rivet 存储 celld 运行边界
接入与验证
候选正常开发POC 验证可能阻塞
Rivet 3自运维 Engine / 磁盘 / 对象桶OpenSandbox provider
Engine / 独立块盘 / 桶配置		TOS 的 CAS / Range；单节点失效
当前升级需全停；演练维护窗口
备份桶 → 新集群恢复：官方尚未验证		OSS 缺所需 CAS；TOS 待验
恢复缺陷可能迫使我们接手 WarpDrive
durable-harnessPG 底座托管；维护服务与队列接入模型 / 远程工具适配
Agent 定义、发布与配额		PG 队列与日志负载
多 Pod 接管、长会话重开
长视频工具、热池 / NAS		PG World 尚未针对规模优化
若负载 / 恢复不达标，可能需改核心
celld自运维节点 / 本地盘 / 对象桶示例升级、PiHarness / 会话 API
Virtual-hosted 寻址
模型与 OpenSandbox provider		TOS 的 CAS / Range
Pi / SQLite / 生命周期兼容
热池 / NAS、领取与产物保存		OSS 缺所需 CAS；TOS 待验
所有权 / 复制缺陷可能需长期维护
durable-harness 自托管 PG World 边界 Rivet K8s Rivet 升级 Rivet 备份恢复 celld 运行边界 TOS 条件写

托管 PG 与对象存储底座怎么取舍

传统 Agent Server + PG 与对象存储底座左右对照共享 PG 与自部署 Actor 运行时的计算、持久化、潜在瓶颈及运维分工；下方列举七种对象存储设计的提交点。SQL / 状态写入持久化 / 复制状态 / 所有权提交 / 下沉Agent Server ×N业务计算横向扩容PG 主库 · SQL / 事务 / 会话潜在瓶颈：连接 / 写入 / WAL / I/O加服务副本 ≠ 增加主库写入能力RDS · 数据盘 / 主备云厂商运维数据库底座Actor / Cell 计算 ×N按状态单元分散执行运行时 / 存储协议所有权 / 日志复制 / 缓存潜在瓶颈：热点对象 / 协调 / I/O对象存储 · S3 等共享持久化底座 · 容量独立增长条件写 CAS · 部分系统用它协调 Manifest / 所有权If-None-Match：不存在才创建；If-Match：ETag 未变才更新；并发冲突由桶拒绝传统 Agent Server + 托管 PG自部署 Actor / 对象存储我们：服务 / Schema / 查询调优 / 恢复演练云托管：PG 主备 / 盘 / 备份能力我们：运行时 / 本地盘 / 升级 / 恢复演练云托管：对象桶；CAS / 配额需核验系统对象桶保存什么提交点 / 本地盘的角色LakehouseParquet + Delta / Iceberg 表文件表格式 / Catalog 管理提交与版本Lakebase页版本 / 历史数据保留 PG 计算；WAL 多数副本确认Cursor OriginGit WAL / packfilepush 持久化到 WAL 后确认turbopuffer文档 / WAL / 索引桶是事实来源；NVMe / RAM 作缓存WarpStream消息数据文件数据面无盘；另有元数据协调服务Rivet 3Actor SQLite / KV 卷磁盘多数确认 → 后台下沉桶celldSQLite LTX / 所有权 / 发布包fleet 日志复制 + 桶；本地盘需保留
Agent Server ×N业务服务与数据库早已分离。增加 Agent Server 副本可增加模型调用和工具调度的并发，但不能直接增加同一 PG 主库的写入容量。
PG 主库 · SQL / 事务 / 会话这是单主共享 PG 的简化模型，不是宣称 PG 必然成为当前业务瓶颈。索引、事务、连接池与队列负载会影响容量；读副本、分片等方案可继续扩展。durable-harness 的 PG World 将会话事件和任务队列放在 PG，需要实测实际负载。
RDS · 数据盘 / 主备本图按当前阿里云托管 PG 候选比较运维分工：云厂商提供主备、盘与备份能力；我们仍负责服务、Schema 迁移、查询与容量，并验证备份保留和恢复。托管程度是部署选择，不是计算存储分离本身带来的保证。
Actor / Cell 计算 ×N每个 Actor / Cell 持有自己的逻辑状态。Rivet 分离 Worker 与 Engine；celld 把执行与存储协议放在同一进程。这是逻辑职责图，不表示 celld 需额外部署独立 Engine；单个热点对象仍受自身写入与所有权协议约束。
运行时 / 存储协议进一步拆开计算执行与持久存储；事务与状态逻辑仍由上层实现。Lakebase 保留 PG 计算；Rivet / celld 使用自己的状态管理协议。对象桶不自动提供全局顺序、多对象事务或恢复，近期日志也不一定是可丢缓存。
对象存储 · S3 等对象存储承接数据文件、日志、快照；计算可以独立替换或扩展。常见设计用批量写入、压缩和缓存平衡延迟与成本；对象桶请求延迟、吞吐和配额仍是边界，能否直接缩零及丢弃本地盘依具体提交协议而定。
条件写 CAS · 部分系统用它协调 Manifest / 所有权AWS S3 于 2024-08 增加条件创建，2024-11 增加 ETag 条件更新。它们提供单对象条件写原语，可用于提交元数据或争抢所有权；仍需上层协议。Lakehouse 等设计早于这些新 API，并非所有存储分离系统都靠它们成立。国内 S3-compatible 后端需要逐项核验，不能只凭兼容名称。
S3 Conditional Writes · 原理博客 AWS · 条件创建 AWS · 条件更新

沙箱后端

当前倾向：OpenSandbox + 现有 ACK + NAS/PVC。复用现有集群与文件存储；我们维护控制组件和执行节点，先验证热池预挂 NAS 与冷启动。

  • ACS 容器版：希望减少执行节点运维时优先对照；需要采用 ACS 算力，仍需配置管理组件。
  • FC 极速版：执行底座托管更完整；先核清视频存储与两代运行时的差异。
  • SPACE：已有 VM 热池与快照优化；维护面更大，本期不优先。
蓝框：我们部署配置 · 橙框：云侧托管 · 红字：能力限制 / 需补写功能 / 待验证

OpenSandbox + ACK

复用现有 ACK、ACR 和 NAS；安装现成沙箱管理组件，执行实例是 ACK 节点上的 Pod。

OpenSandbox + ACK：部署实体与托管边界七个实体在四个方案中保持坐标一致；蓝色区域由我们部署配置，橙色区域由云侧托管。箭头展示环境发布、领取、工具调用、文件挂载及执行算力。普通安装配置不标红。我们部署与配置 · 现有 ACK、Agent 服务与 OpenSandbox云侧托管 · 环境制品与持久文件存储配置 / 领取 / 释放发布环境保存制品预热 / 分配运行在文件与命令调用加载镜像 / 模板挂载工作目录我们的产品控制面与 Agent 服务Agent 定义、会话与任务派发包含沙箱适配、任务目录绑定和产物管理环境构建任务发布时打包工具、Skill 与初始文件模板构建版本化镜像，再推送环境制品仓库沙箱管理服务 · OpenSandbox在 ACK 部署 API、Controller 与入口组件配置镜像、规格、挂载和 Pool 容量工具沙箱实例 · Pod × Nexecd 提供文件与命令接口统一执行 read / write / edit / bash执行算力 · ACK 节点 / ECS我们配置执行节点池与隔离方式强化隔离与 NAS 组合待验证环境制品存储 · 阿里云 ACR保存发布后的环境镜像预热或创建实例时拉取持久文件存储 · 阿里云 NASPool 提前挂卷；领取时不能追加卷任务目录隔离与产物保留需验证

ACS Agent Sandbox · 容器版

管理组件仍由我们安装，执行算力由 ACS 托管；Agent 服务可以继续留在现有 ACK。

ACS Agent Sandbox · 容器版：部署实体与托管边界七个实体在四个方案中保持坐标一致；蓝色区域由我们部署配置，橙色区域由云侧托管。箭头展示环境发布、领取、工具调用、文件挂载及执行算力。普通安装配置不标红。我们部署 · Agent 服务与环境构建我们部署 · ACS 管理组件云侧托管 · ACS 执行实例与算力云侧托管 · 环境制品与持久文件存储配置 / 领取 / 释放发布环境保存制品预热 / 分配运行在文件与命令调用加载镜像 / 模板挂载工作目录我们的产品控制面与 Agent 服务Agent 定义、会话与任务派发包含沙箱适配、任务目录绑定和产物管理环境构建任务发布时打包工具、Skill 与初始文件模板构建版本化镜像，再推送环境制品仓库沙箱管理服务 · ACS 管理组件我们在 ACS 集群安装 Controller / Manager / 入口配置 SandboxSet 热池、规格和挂载工具沙箱实例 · ACS 容器实例管理组件分配执行实例文件和命令通过沙箱 API 调用执行算力 · ACS 托管算力云侧调度和运行执行实例执行实例不能使用现有 ACK 节点池环境制品存储 · 阿里云 ACR我们构建环境镜像并推送仓库执行实例启动时加载持久文件存储 · 阿里云 NAS / OSS官方提供动态挂载配置路径视频 I/O 与任务目录隔离待验证

Agent Sandbox 极速版 · FC

沙箱管理和执行底座交给云侧，我们提供环境与 API 接入；视频存储路径需按运行时代际选择。

Agent Sandbox 极速版 · FC：部署实体与托管边界七个实体在四个方案中保持坐标一致；蓝色区域由我们部署配置，橙色区域由云侧托管。箭头展示环境发布、领取、工具调用、文件挂载及执行算力。普通安装配置不标红。我们部署 · Agent 服务与环境构建云侧托管 · 沙箱管理与执行底座云侧托管 · 环境制品与持久文件存储配置 / 领取 / 释放发布环境保存制品预热 / 分配运行在文件与命令调用加载镜像 / 模板挂载工作目录我们的产品控制面与 Agent 服务Agent 定义、会话与任务派发包含沙箱适配、任务目录绑定和产物管理环境构建任务发布时打包工具、Skill 与初始文件模板构建版本化镜像，再推送环境制品仓库沙箱管理服务 · 阿里云托管 API云侧提供生命周期与预热能力我们配置环境版本、规格与使用额度工具沙箱实例 · FC 托管实例云侧提供文件与命令接口二代 MicroVM（Beta）；支持快照 / Fork执行算力 · FC 托管底座云侧负责执行资源的调度和运行我们选择规格、并发和预热配置环境制品存储 · 镜像 / 模板一代使用环境镜像；二代使用自定义模板云侧按所选运行时提供环境预热持久文件存储 · NAS / OSS 等一代可挂 NAS；二代动态存储未列 NAS二代列 OSS / AgenticFS；视频路径需验证

Perplexity SPACE

自行部署完整 VM 沙箱平台，已有热池与基础快照优化；需准备 VM 宿主环境并验证 NAS 接入。

Perplexity SPACE：部署实体与托管边界七个实体在四个方案中保持坐标一致；蓝色区域由我们部署配置，橙色区域由云侧托管。箭头展示环境发布、领取、工具调用、文件挂载及执行算力。普通安装配置不标红。我们部署与配置 · Agent 服务、SPACE 与 VM 宿主云侧托管 · 环境制品与持久文件存储配置 / 领取 / 释放发布环境保存制品预热 / 分配运行在文件与命令调用加载镜像 / 模板挂载工作目录我们的产品控制面与 Agent 服务Agent 定义、会话与任务派发包含沙箱适配、任务目录绑定和产物管理环境构建任务发布时打包工具、Skill 与初始文件模板准备 VM 模板，交给 Builder 构建沙箱管理服务 · SPACE我们部署 API、Controller、PG 与相关组件K8s 热池；单节点另有基础快照启动工具沙箱实例 · Firecracker VM × N我们部署 Worker 与执行数据通道在 VM 中执行文件读写和命令执行算力 · VM 宿主节点我们准备 KVM / btrfs / 特权宿主环境执行实例运行在这些宿主节点上环境制品存储 · 对象存储Builder 生成 VM 模板与快照使用外部对象桶保存环境制品持久文件存储 · NAS（待接入）VM 挂载通道、权限与视频 I/O 待验证不能直接照搬 K8s PVC 挂载配置
ACS 容器版 / 热池 极速版两代运行时 / NAS SPACE 热池 SPACE 基础快照 SPACE 安装要求
接入与验证
已支持普通 K8s PVC / subPath；Pool 模板静态预挂 RWX PVC。领取时不能追加卷。
正常开发provider 接入；按 Pod 身份预绑 NAS 子目录（候选：subPathExpr）；run → sandbox → 目录；确认产物后销毁补池与目录清理。
待实测ACK + NAS + 隔离 runtime；目录可见范围、销毁后产物保留；领取到工具就绪、视频首读 / seek、并发吞吐与池耗尽。
降权暂停 / 恢复、进程内存快照；主负载为后台 Agent 跑完结束、保留产物。
OpenSandbox PVC / Pool K8s subPathExpr ACK NAS

产品职责参考

绿框：职责覆盖（含接入） · 灰：外部依赖 / 未确认

Rivet

Rivet 职责覆盖固定节点位置；绿色区域包含原生能力、部分子能力和适配接口，边界见节点说明。发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置会话 / 状态配置 / 版本模型 / API 调用UI / API / 消息 / WebhookAgent 托管控制面Agent 定义与发布Environment 定义Workspace 模板与绑定Agent Runtime APITrigger / Cron / 批量派发Session / Run / subagentAgent Harness会话与执行状态环境构建任务沙箱管理服务工具沙箱实例 × N模型 / 可信 API持久文件存储镜像仓库会话与配置存储
UI / API / 消息 / Webhook由外部组件补齐。
Agent 托管控制面由外部组件补齐。
Agent 定义与发布代码定义 Agent 与工具；声明式项目发布仍需上层补齐。
Environment 定义通过 SandboxProvider 承接环境；默认 Docker provider 没有完整 CPU / 内存配置。
Workspace 模板与绑定由外部组件补齐。
Agent Runtime API已有 Actor / Pi 的调用与订阅基础；平台统一的发起、查询和终止接口由我们封装。
Trigger / Cron / 批量派发提供 Cron；业务批量队列与并发额度需补齐。
Session / Run / subagentActor、会话与 subagent；业务父子关系和取消策略需明确。
Agent HarnessPi Durable 在 Actor 中运行；完整 Pi 在 Pod 内可使用 Sandbox Agent 接口。
会话与执行状态Actor SQLite 保留对话与执行状态；引擎部署按 2.3 / 3.0 分别核验。
环境构建任务由外部组件补齐。
沙箱管理服务提供生命周期接口；OpenSandbox provider 是正常接入开发，不作为选型阻塞。
工具沙箱实例 × N文件和 shell 工具通过执行环境进入沙箱。
模型 / 可信 API由外部组件补齐。
持久文件存储文件保存依赖执行环境；NAS 挂载需要 provider 适配，不由 Actor 状态自动兜底。
镜像仓库使用外部镜像仓库；支持拉取环境镜像不等于提供镜像仓库服务。
会话与配置存储Actor SQLite 保留对话与执行状态；引擎部署按 2.3 / 3.0 分别核验。

OpenSandbox

OpenSandbox 职责覆盖固定节点位置；绿色区域包含原生能力、部分子能力和适配接口，边界见节点说明。发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置会话 / 状态配置 / 版本模型 / API 调用UI / API / 消息 / WebhookAgent 托管控制面Agent 定义与发布Environment 定义Workspace 模板与绑定Agent Runtime APITrigger / Cron / 批量派发Session / Run / subagentAgent Harness会话与执行状态环境构建任务沙箱管理服务工具沙箱实例 × N模型 / 可信 API持久文件存储镜像仓库会话与配置存储
UI / API / 消息 / Webhook由外部组件补齐。
Agent 托管控制面由外部组件补齐。
Agent 定义与发布由外部组件补齐。
Environment 定义支持镜像与资源规格；普通 K8s 后端传递 requests / limits。
Workspace 模板与绑定由外部组件补齐。
Agent Runtime API由外部组件补齐。
Trigger / Cron / 批量派发由外部组件补齐。
Session / Run / subagent由外部组件补齐。
Agent Harness由外部组件补齐。
会话与执行状态由外部组件补齐。
环境构建任务由外部组件补齐。
沙箱管理服务已支持：普通 K8s Pool 预热与模板预挂 PVC；正常开发包括领取、目录关联与销毁补池；POC 测热池命中/耗尽延迟。暂停恢复本期降权。
工具沙箱实例 × N提供命令、文件与进程接口；ffmpeg / 浏览器依赖需装入镜像。 隔离配置：接入具体 RuntimeClass / 后端；NAS 和快照兼容性需逐一核验。
模型 / 可信 API由外部组件补齐。
持久文件存储已支持：普通 K8s PVC/subPath、Pool 模板静态挂卷；需适配按 Pod 预绑定目录和产物发布。待测 ACK+NAS+隔离 runtime 的可见范围与视频 I/O。领取时不能追加卷。
镜像仓库使用外部镜像仓库；支持拉取环境镜像不等于提供镜像仓库服务。
会话与配置存储由外部组件补齐。

eve

eve 职责覆盖固定节点位置；绿色区域包含原生能力、部分子能力和适配接口，边界见节点说明。发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置会话 / 状态配置 / 版本模型 / API 调用UI / API / 消息 / WebhookAgent 托管控制面Agent 定义与发布Environment 定义Workspace 模板与绑定Agent Runtime APITrigger / Cron / 批量派发Session / Run / subagentAgent Harness会话与执行状态环境构建任务沙箱管理服务工具沙箱实例 × N模型 / 可信 API持久文件存储镜像仓库会话与配置存储
UI / API / 消息 / Webhook提供 API、消息渠道与开发入口；业务 UI 可自行接入。
Agent 托管控制面提供 Agent 项目开发与运行能力；业务租户、资源管理需补齐。
Agent 定义与发布目录声明 instructions、tools、skills、channels 和 schedules。
Environment 定义镜像和 Dockerfile 通过 sandbox provider 配置。
Workspace 模板与绑定由外部组件补齐。
Agent Runtime API提供 Session 运行与查询接口；平台统一 Runtime API 按业务接入，具体操作边界沿用已有会话能力。
Trigger / Cron / 批量派发支持 schedules；多副本需控制单一 Cron runner。
Session / Run / subagent提供 Session 与 subagents；多副本需共享 world。
Agent Harness使用 eve 自带 harness，不是直接替换为 Pi 的配置项。
会话与执行状态持久执行依赖 Workflow world；升级可能使旧 run 无法继续。
环境构建任务由外部组件补齐。
沙箱管理服务可用 Docker、Vercel 或自建 provider；接 OpenSandbox 需适配。
工具沙箱实例 × N通过沙箱后端运行工具。
模型 / 可信 API由外部组件补齐。
持久文件存储工作文件默认留在会话容器；独立持久 Workspace 需要后端补齐。
镜像仓库使用外部镜像仓库；支持拉取环境镜像不等于提供镜像仓库服务。
会话与配置存储持久执行依赖 Workflow world；升级可能使旧 run 无法继续。

Agent 定义与发布

agent/
├── agent.ts
├── instructions.md
├── tools/inspect_video.ts
├── skills/video/SKILL.md
├── connections/media.ts
├── hooks/check.ts
├── schedules/daily.md
├── subagents/editor/agent.ts
└── sandbox/
    ├── sandbox.ts
    └── workspace/
目录即契约
路径决定工具、技能、渠道、定时任务和 subagent 如何被发现。
文本写意图，代码写行为
Markdown 保存指令与技能；TypeScript 定义模型、工具、hook 和外部连接。
项目即构建单元
发现与校验 → 编译 Manifest 和代码 → 构建产物 → 部署。
agent/agent.ts
import { defineAgent } from "eve";

export default defineAgent({
  model: "anthropic/claude-opus-5.5",
});

我们的接入：参考目录组织；工具与 hook 采用 Pi Durable 原生接口，Environment 另行绑定镜像与资源。

目录与发现规范defineAgent 配置构建与 Manifest

Centaur

Centaur 职责覆盖固定节点位置；绿色区域包含原生能力、部分子能力和适配接口，边界见节点说明。发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置会话 / 状态配置 / 版本模型 / API 调用UI / API / 消息 / WebhookAgent 托管控制面Agent 定义与发布Environment 定义Workspace 模板与绑定Agent Runtime APITrigger / Cron / 批量派发Session / Run / subagentAgent Harness会话与执行状态环境构建任务沙箱管理服务工具沙箱实例 × N模型 / 可信 API持久文件存储镜像仓库会话与配置存储
UI / API / 消息 / Webhook提供 API、Slack 与 Console。
Agent 托管控制面提供团队 Agent 平台；业务入口和模板仍需适配。
Agent 定义与发布提供 Agent 与 harness 配置；完整产品契约按业务扩展。
Environment 定义支持镜像、资源、卷和 RuntimeClass。
Workspace 模板与绑定可启用持久卷保存工作目录和会话，stateVolume 默认关闭；初始文件模板按业务补齐。
Agent Runtime APIAPI 提供会话与执行管理；统一 Runtime API 需要适配，终止与恢复语义逐项核验。
Trigger / Cron / 批量派发有消息触发和持久执行；通用 Cron 与批量额度需核验。
Session / Run / subagent管理消息、会话和执行；subagent 业务契约仍需核验。
Agent Harness本产品 harness 在沙箱内运行；已有 Pi RPC 适配，已审查文档限定 Slack 选择。
会话与执行状态PostgreSQL 保存消息与执行事件；原生会话依赖持久卷。
环境构建任务由外部组件补齐。
沙箱管理服务使用 SIG Agent Sandbox 控制器。
工具沙箱实例 × N工具与完整 harness 位于执行沙箱。 隔离配置：隔离依赖配置的运行时。
模型 / 可信 API由外部组件补齐。
持久文件存储开启 stateVolume 后 PVC 可保存工作与会话；最终删除沙箱会清理，产物需另存；暂停不等于内存快照。
镜像仓库使用外部镜像仓库；支持拉取环境镜像不等于提供镜像仓库服务。
会话与配置存储PostgreSQL 保存消息与执行事件；原生会话依赖持久卷。

Claude Managed Agents

Claude Managed Agents 职责覆盖固定节点位置；绿色区域包含原生能力、部分子能力和适配接口，边界见节点说明。发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置会话 / 状态配置 / 版本模型 / API 调用UI / API / 消息 / WebhookAgent 托管控制面Agent 定义与发布Environment 定义Workspace 模板与绑定Agent Runtime APITrigger / Cron / 批量派发Session / Run / subagentAgent Harness会话与执行状态环境构建任务沙箱管理服务工具沙箱实例 × N模型 / 可信 API持久文件存储镜像仓库会话与配置存储
UI / API / 消息 / Webhook提供 Console 与 API；业务入口自行接入。
Agent 托管控制面托管 Agent 定义、Session 与执行。
Agent 定义与发布提供模型、工具、Skills 等 Agent 配置。
Environment 定义提供托管环境配置；不能据此认定开放任意镜像、CPU / 内存规格。
Workspace 模板与绑定提供环境文件和附件；不是任意 NAS 挂载服务。
Agent Runtime API平台提供 Session 运行控制与状态查询；业务入口通过托管 API 接入。
Trigger / Cron / 批量派发提供 Scheduled Deployments。
Session / Run / subagent托管 Session 与长时任务；高级编排能力按开放状态核验。
Agent Harness由平台托管 harness，与工具沙箱分离。
会话与执行状态平台托管会话和执行状态。
环境构建任务平台准备与管理执行环境；底层模板构建实现未公开。
沙箱管理服务平台提供沙箱生命周期。
工具沙箱实例 × N托管工具执行沙箱。 隔离配置：平台提供隔离；底层内核实现未公开。
模型 / 可信 APIAnthropic 提供 Claude 模型；自定义工具的第三方 API 仍由外部服务提供。
持久文件存储平台托管工作文件和附件；不等于分支 FS 或 NAS 大视频直挂能力。
镜像仓库托管平台内部的环境制品实现未公开；此处未确认独立镜像仓库能力，不表示用户必须自行部署仓库。
会话与配置存储平台托管会话和执行状态。

Agent Substrate

Agent Substrate 职责覆盖固定节点位置；绿色区域包含原生能力、部分子能力和适配接口，边界见节点说明。发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置会话 / 状态配置 / 版本模型 / API 调用UI / API / 消息 / WebhookAgent 托管控制面Agent 定义与发布Environment 定义Workspace 模板与绑定Agent Runtime APITrigger / Cron / 批量派发Session / Run / subagentAgent Harness会话与执行状态环境构建任务沙箱管理服务工具沙箱实例 × N模型 / 可信 API持久文件存储镜像仓库会话与配置存储
UI / API / 消息 / Webhook由外部组件补齐。
Agent 托管控制面由外部组件补齐。
Agent 定义与发布由外部组件补齐。
Environment 定义Actor / WorkerPool 定义镜像与执行规格。
Workspace 模板与绑定由外部组件补齐。
Agent Runtime API由外部组件补齐。
Trigger / Cron / 批量派发由外部组件补齐。
Session / Run / subagent由外部组件补齐。
Agent Harness由外部组件补齐。
会话与执行状态由外部组件补齐。
环境构建任务由外部组件补齐。
沙箱管理服务管理 Actor 激活、预热容量、快照与恢复。
工具沙箱实例 × N承载镜像内的执行进程；不负责 Agent 工具契约。 隔离配置：接入隔离 worker runtime；按部署后端核验。
模型 / 可信 API由外部组件补齐。
持久文件存储保存 RAM 与根文件系统快照；NAS 外部卷与分支 FS 需另外核验。
镜像仓库使用外部镜像仓库；支持拉取环境镜像不等于提供镜像仓库服务。
会话与配置存储由外部组件补齐。

Perplexity SPACE

Perplexity SPACE 职责覆盖固定节点位置；绿色区域包含原生能力、部分子能力和适配接口，边界见节点说明。发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置会话 / 状态配置 / 版本模型 / API 调用UI / API / 消息 / WebhookAgent 托管控制面Agent 定义与发布Environment 定义Workspace 模板与绑定Agent Runtime APITrigger / Cron / 批量派发Session / Run / subagentAgent Harness会话与执行状态环境构建任务沙箱管理服务工具沙箱实例 × N模型 / 可信 API持久文件存储镜像仓库会话与配置存储
UI / API / 消息 / Webhook由外部组件补齐。
Agent 托管控制面由外部组件补齐。
Agent 定义与发布由外部组件补齐。
Environment 定义通过 Template 定义 VM 执行环境。
Workspace 模板与绑定由外部组件补齐。
Agent Runtime API由外部组件补齐。
Trigger / Cron / 批量派发由外部组件补齐。
Session / Run / subagent由外部组件补齐。
Agent Harness由外部组件补齐。
会话与执行状态由外部组件补齐。
环境构建任务提供模板；单节点基础快照保存已启动模板的内存与 VM 状态，用于加速新建。
沙箱管理服务已有 Kubernetes warm pool：领取预启动 VM，无匹配容量则回退冷启动；单节点有基础快照与节点池路径。运行中任务的 suspend 快照是另一种用途。部分 checkpoint API 仍在孵化。
工具沙箱实例 × N提供独立命令执行与数据通道。 隔离配置：基于 Firecracker microVM；官方安装路径涉及 KVM、tun、loop 与 btrfs，需要节点配置。
模型 / 可信 API由外部组件补齐。
持久文件存储根文件系统属于 VM 状态；ACK NAS 的直挂、权限与恢复尚未验证，不据此判定不支持。
镜像仓库使用外部镜像仓库；支持拉取环境镜像不等于提供镜像仓库服务。
会话与配置存储由外部组件补齐。

LayerFS

LayerFS 职责覆盖固定节点位置；绿色区域包含原生能力、部分子能力和适配接口，边界见节点说明。发布构建推送拉取镜像预热 / 分配 / 回收首次领取 / 结束释放文件 / 命令挂载资源配置会话 / 状态配置 / 版本模型 / API 调用UI / API / 消息 / WebhookAgent 托管控制面Agent 定义与发布Environment 定义Workspace 模板与绑定Agent Runtime APITrigger / Cron / 批量派发Session / Run / subagentAgent Harness会话与执行状态环境构建任务沙箱管理服务工具沙箱实例 × N模型 / 可信 API持久文件存储镜像仓库会话与配置存储
UI / API / 消息 / Webhook由外部组件补齐。
Agent 托管控制面由外部组件补齐。
Agent 定义与发布由外部组件补齐。
Environment 定义可选 Docker 镜像；没有完整 CPU / 内存资源规格。
Workspace 模板与绑定从同一快照分叉，未修改内容共享，各分支独立记录文件增量；支持提交与合并，对话 fork 需 Harness 配对。
Agent Runtime API由外部组件补齐。
Trigger / Cron / 批量派发由外部组件补齐。
Session / Run / subagent由外部组件补齐。
Agent Harness由外部组件补齐。
会话与执行状态由外部组件补齐。
环境构建任务由外部组件补齐。
沙箱管理服务自带单机 Docker 沙箱管理；不提供集群调度。
工具沙箱实例 × N可在挂载 Workspace 后 exec / bash。
模型 / 可信 API由外部组件补齐。
持久文件存储保存代码、依赖、缓存、忽略文件的历史，不保存进程或内存。Store 依赖同一 Linux 内核和本地磁盘，不能直接当成 NAS 上的多节点分支 FS。
镜像仓库使用外部镜像仓库；支持拉取环境镜像不等于提供镜像仓库服务。
会话与配置存储由外部组件补齐。
LayerFS：共享快照与独立增量分支两个 Agent 从同一文件快照分叉，共享未修改的文件内容，分别提交自己的增量；Harness 负责配对对话与文件分支，运行中的进程和内存不属于文件历史。共享基础快照 C0代码 / 依赖 / 缓存 / 忽略文件未修改的内容共享，不复制完整目录Agent A · 分支 AC0 + ΔA · 独立可写尝试方案一Agent B · 分支 BC0 + ΔB · 独立可写尝试方案二提交检查点 / 选择或显式合并保留结果，也可从历史快照再分叉对话 fork ↔ Workspace fork：Harness 配对；不含进程 / 内存Δ 是文件增量，不只文本 diff；父分支后续修改不会自动进入子分支并行试验 → 分支 FS；共享视频 / 独立产物 → NAS
共享基础快照 C0LayerFS Init 纳入整个项目目录，不受 Git ignore 过滤。fork 记录起点，不复制文件；内容按块压缩去重。图中的 C0 是不可变的快照引用，分支 A/B 从同一状态出发。
Agent A · 分支 A每个 Workspace 有自己的可写 overlay；提交保存新的文件树与内容增量。Δ 是逻辑上的文件增量，包括二进制内容，不限于文本 diff。父分支之后的新修改不会自动进入该分支。
Agent B · 分支 B与分支 A 共用未改动内容，但写入互不影响。分支引用的是 fork 时的快照；需要其他分支的更新时显式合并。
提交检查点 / 选择或显式合并LayerFS 保存提交与文件历史。合并和发布是显式操作，不会自动选择最优结果，也不自动解决所有文件冲突。对话 fork 与 Workspace fork 的对应关系仍由 Harness 管理。
LayerFS · 分支 / Workspace / 历史 LayerFS · 存储实现

参考资料

Claude Managed Agents
Harness / Sandbox 分离
Agent Substrate
Actor / 快照恢复
SPACE
microVM 控制面
LayerFS
Workspace 分叉与合并