OpenSandbox + ACK
复用现有 ACK、ACR、NAS；沙箱控制组件、执行节点和热池由我们维护。
durable-harness + 托管 PG + OpenSandbox
UI / API / 消息 / Webhook三类入口共用 Agent 运行底座；批量提交一组独立 Agent，subagent 由父 Agent 派发，不预设 Workflow。
Agent 托管控制面提供声明式定义与发布，以及发起、查询、终止接口。配置与版本存 PG；执行命令交给 durable-harness / Pi，状态与事件从 World 日志读取。Rivet 3 保留为运行底座对照，不叠加两套会话调度。
Agent 定义与发布自有项目契约，参考 eve 的声明式开发体验。定义、发布和业务配额由我们补齐；Pi 持久化与恢复队列复用已有框架。
Environment 定义自有环境契约，先构建和校验，再生成不可变环境版本。系统依赖与 Agent 提示词、Skills 分开管理。
Workspace 模板与绑定定义初始文件树与 NAS 数据卷。后台任务以完成后保留产物为主；Pool 模板可预挂 PVC。按 Pod 预绑定目录及 run→sandbox→目录映射需我们适配，目录可见范围和 RuntimeClass 兼容需 ACK 实测。
Agent Runtime API控制面内的运行时接口，发起和终止命令交给 Session / Run 与 Pi；查询状态、进度和输出事件关联会话与执行状态。终止当前执行仍保留已持久化会话和工作文件。
Trigger / Cron / 批量派发建议接现有 Cron 触发 Runtime API；一批任务对应一组独立 session，按业务配额派发。World 使用 PG 队列；触发、并发额度与结果汇总仍需接入，不把批量 Agent 改成业务 Workflow。
Session / Run / subagent后台任务按独立 session 运行；Pi 子会话可复用，但不等于跨 Pod 独立调度已验证。需接入父子关系、独立子 session 派发与汇总，并测试父等待子时的执行槽、完成唤醒和终止传播。
服务端 HarnessPi 原生 Harness 通过 durable-harness 接入 PG World，模型可自配；重工具经 ExecutionEnv / 工具适配进入 OpenSandbox。SDK / provider 是正常开发，PG 负载和跨 Pod 接管做 POC；不是从零实现 Agent Harness。
会话与执行状态Pi commit 写入 World 事件日志，PG 同时承载 graphile-worker 队列；本方案不使用每 session SQLite 或对象桶 CAS。RDS 提供数据库运维能力，PG World 仍是未针对规模优化的参考实现。NAS 视频与产物独立保存。
环境构建 / 镜像与模板复用 CI 和国内 ACR，构建固定环境版本并预拉依赖。首期重点是预热到工具与 NAS 已就绪；镜像预拉不等于就绪热池，挂载完成不等于视频内容已缓存。
沙箱冷启动 / 热池已支持：普通 K8s Pool 模板预挂 PVC；领取时不能追加 volumes。正常开发：provider、按 Pod 预绑定独立目录、任务映射与结束后销毁补池。待实测：ACK 领取到首条工具命令、池耗尽排队与补池。暂停/恢复降权。
工具沙箱领取已预热工具沙箱，读取 NAS 视频，中间文件用本地 /scratch，确认产物保存后销毁。冷启动看任务领取到工具就绪，并单测首次视频读/seek；NAS 吞吐与并发需 ACK 实测。
隔离 Runtime / Driver自建后端按集群支持验证 gVisor / Kata 的 NAS 可见性、冷启动和视频 I/O。暂停 / RAM 快照降权；Fast Sandbox 当前拒绝动态卷，不能直接套用普通 K8s 的 NAS 能力。
模型推理 / 可信 API复用现有模型与 API。模型选择、调用凭证和限额由平台配置；本轮不新增模型网关选型。
NAS 大视频 / 工作目录 / 产物已支持：普通 K8s PVC/subPath 与 Pool 模板静态预挂载。候选：subPathExpr 按 Pod UID 在预热时选目录，领取时绑定 run，完成后保留产物并销毁 Pod。该组合需适配与 ACK 实测；共享 PVC 不随任务删除，不能用 cwd 充当目录隔离。
- 在线 Agent
- 连续对话、流式输出、会话重连。
- 后台 / 批量 Agent
- 一任务一会话，按配额并发；读取大视频，完成后保留产物。
- subagent
- 父 Agent 按需派发子任务，独立执行并汇总结果。
架构与职责
UI / API / 消息 / Webhook作用：接收请求与外部事件。选型考虑：入口协议 / 流式连接。
Agent 托管控制面作用：管理定义、发布与运行。选型考虑：权限 / 版本 / 配额。
Agent 定义与发布作用：配置模型、工具与技能。选型考虑：定义格式 / 扩展接口。
Environment 定义作用：定义工具运行环境。选型考虑：镜像 / 规格 / 就绪条件。
Workspace 模板与绑定作用：定义与绑定初始目录。选型考虑：初始树 / 挂载 / 产物。
Agent Runtime API作用：发起、查询和终止执行。选型考虑：调用契约 / 状态语义。
Trigger / Cron / 批量派发作用：按时间或批量派发任务。选型考虑：Cron / 并发配额 / 排队。
Session / Run / subagent作用：管理会话、执行与子任务。选型考虑：父子关系 / 并发 / 恢复。
服务端 Harness作用：模型循环与工具编排。选型考虑：扩展 API / 上下文管理。
会话与执行状态作用：保留进度与执行记录。选型考虑：恢复 / 故障接管 / 迁移。
环境构建 / 镜像与模板作用：准备工具与系统依赖。选型考虑：预拉 / 缓存 / 就绪检查。
沙箱冷启动 / 热池作用：分配、复用和回收环境。选型考虑：热池 / 领取延迟 / 补池。
工具沙箱作用：执行命令与重资源工具。选型考虑：进程控制 / 超时 / 通道。
隔离 Runtime / Driver作用：提供执行隔离边界。选型考虑：隔离强度 / 挂载兼容。
模型推理 / 可信 API作用：提供推理和外部能力。选型考虑：接口 / 凭证 / 调用配额。
工作文件 / 大视频 / 产物作用：持久保存工作文件。选型考虑：挂载 / 吞吐 / 文件隔离。
为什么把 Harness 放在服务端
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。
筛选逻辑
Agent 运行底座
| 方案 | 运行模型 | 主要优势 | 主要代价 |
|---|---|---|---|
| durable-harness | Node 服务 + Pi Durable PG 保存事件与任务队列 | 原生复用 Pi Durable 托管 PG，减少底层运维 | 扩展受 PG 与 PG World 约束 并发与恢复仍需 POC |
| Rivet 3 | 按 key 寻址的 Actor 每个 Actor 独立 SQLite | Actor 调度、休眠与唤醒 适合大量长期会话 | 自管 Engine、磁盘与对象桶 3.0 仍处于 Preview |
| celld | Durable Objects API + SQLite 每节点一个 Rust 进程 | 熟悉的 DO 编程模型 运行时外部依赖少 | 对象桶必须满足 CAS 自管节点与本地盘恢复 |
接入与验证
| 候选 | 正常开发 | POC 验证 | 可能阻塞 |
|---|---|---|---|
| durable-harnessPG 底座托管；维护服务与队列接入 | 模型 / 远程工具适配 Agent 定义、发布与配额 | PG 队列与日志负载 多 Pod 接管、长会话重开 长视频工具、热池 / NAS | PG World 尚未针对规模优化 若负载 / 恢复不达标，可能需改核心 |
| Rivet 3自运维 Engine / 磁盘 / 对象桶 | OpenSandbox provider Engine / 独立块盘 / 桶配置 | TOS 的 CAS / Range；单节点失效 当前升级需全停；演练维护窗口 备份桶 → 新集群恢复：官方尚未验证 | OSS 缺所需 CAS；TOS 待验 恢复缺陷可能迫使我们接手 WarpDrive |
| celld自运维节点 / 本地盘 / 对象桶 | 示例升级、PiHarness / 会话 API Virtual-hosted 寻址 模型与 OpenSandbox provider | TOS 的 CAS / Range Pi / SQLite / 生命周期兼容 热池 / NAS、领取与产物保存 | OSS 缺所需 CAS；TOS 待验 所有权 / 复制缺陷可能需长期维护 |
托管 PG 与对象存储底座怎么取舍
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 后端需要逐项核验，不能只凭兼容名称。
沙箱后端
当前倾向：OpenSandbox + 现有 ACK + NAS/PVC。复用现有集群与文件存储；我们维护控制组件和执行节点，先验证热池预挂 NAS 与冷启动。
- ACS 容器版：希望减少执行节点运维时优先对照；需要采用 ACS 算力，仍需配置管理组件。
- FC 极速版：执行底座托管更完整；先核清视频存储与两代运行时的差异。
- SPACE：已有 VM 热池与快照优化；维护面更大，本期不优先。
红字：维护负担、能力限制或待验证
ACS Agent Sandbox · 容器版
云侧承担执行算力；我们仍需配置 ACS 管理组件、热池和业务接入，不能直接复用现有 ACK。
Agent Sandbox 极速版 · FC
执行底座与预热交给云侧；NAS 优先看一代，二代 MicroVM 的动态存储目前未列 NAS。
Perplexity SPACE
已有 VM 热池与快照启动优化；我们需维护完整控制面和虚拟机宿主环境，ACK + NAS 路径尚未验证。
接入与验证
| 已支持 | 普通 K8s PVC / subPath；Pool 模板静态预挂 RWX PVC。领取时不能追加卷。 |
|---|---|
| 正常开发 | provider 接入；按 Pod 身份预绑 NAS 子目录（候选：subPathExpr）；run → sandbox → 目录；确认产物后销毁补池与目录清理。 |
| 待实测 | ACK + NAS + 隔离 runtime；目录可见范围、销毁后产物保留；领取到工具就绪、视频首读 / seek、并发吞吐与池耗尽。 |
| 降权 | 暂停 / 恢复、进程内存快照；主负载为后台 Agent 跑完结束、保留产物。 |
ACK 部署映射
橙：阿里云实体蓝：K8s / 软件虚线节点：待确认
durable-harness + Pi Durable + OpenSandbox
原生接入 Pi Durable，用托管 PG 保存会话与队列，减少底层运维；PG World 的并发与恢复表现仍待验证。
阿里云 ALB部署建议：ALB Ingress 接产品 API；SSE 链路配置适合长任务的超时。World 队列路由只供内网使用。
产品 API · Deployment正常开发：Agent 定义、发布、租户鉴权、批量派发与并发配额。可复用 durable-harness 的聊天、重连与会话读取接口；不是从零实现 Pi 的持久化或恢复队列。
Agent Server Pod · Deployment ×NPG World 是 Vercel 维护的 @workflow/world-postgres，加载在同一个 Agent Server 的 Node.js 进程中；Graphile Worker 负责消费同一 PG 内的队列，无需独立部署 World 服务。官方定位是完整且有测试的参考实现，未针对规模、速度或安全优化。Pi commit 作为 World 事件写入 PG，重开时回放日志；这里不是每会话一个 SQLite。正常开发：OpenSandbox ExecutionEnv。多 Pod 接管、并发和长会话恢复需 POC。
OpenSandbox 控制组件沿用已审查版本：Lifecycle Server 默认单活，K8s controller 多副本选主。durable-harness 原生 sandboxEnv 对接 Vercel Sandbox；本组合通过 Pi ExecutionEnv / 工具接口接 OpenSandbox，尚无现成适配器，不假定直接替换 endpoint 即可使用。
工具 Sandbox Pod ×N重工具调用进入真实 Linux 沙箱。Pi 与会话状态仍留在 Agent Server / PG；大视频通过 NAS 路径传递，不写入 World 日志。virtualEnv 是虚拟 FS / just-bash，不能运行真实 ffmpeg，不能替代本节点。
Pool / NAS 预挂载 · 已支持Pool 模板预挂 RWX PVC；候选方案按 Pod UID 预绑定子目录，领取时保存任务映射，结束保留产物后销毁补池。适配目录权限和产物发布，实测 ACK NAS 隔离、热池命中/耗尽及视频首读；不在领取时动态追加卷。
RDS PostgreSQL · 持久化 + 队列这是本方案的 Agent 运行时存储依赖，不只是产品配置库。PG World 已实现完整接口，但官方定位为未针对规模优化的参考实现；需验证 PG 压力、多 Pod 接管和长会话重开。若必须长期改写队列/持久化核心，才升级为选型阻塞；生产前需限制未认证的内部队列路由。
阿里云 NAS · 大视频与产物NAS 独立保存大视频输入、工作文件和产物；PG 只保存会话、工具结果与文件引用。OpenSandbox 销毁后产物目录保留，由产品控制面维护归属与清理。预挂载不等于视频已缓存。
ACR 镜像仓库正常部署工作：固定 durable-harness / Pi / PG World 版本，构建 Node 服务与工具镜像并同步 ACR。仓库包含 demo，未提供本组合的一键 ACK 安装包。
RAM / KMS接现有凭证配置。PG 凭证交服务端，模型不强制 Vercel 网关；远程工具按业务授权获取所需权限。
VPC 出网可信模型与 API 调用在 Agent Server 进行；需要 bash / ffmpeg / 浏览器时才调用 OpenSandbox。Pi 路线可以脱离 Vercel 托管模型与沙箱服务。
Rivet 3 + Pi Durable + OpenSandbox
提供 Actor 寻址、独立 SQLite 与休眠唤醒；需自运维 Engine、磁盘和对象桶，并验证升级与恢复。
阿里云 ALB建议用阿里 ALB Ingress 接入产品 API。ALB 是阿里云负载均衡产品，Ingress 是 K8s 路由规则。Rivet Engine 与 OpenSandbox 管理服务保留内网入口；长连接链路需配置超时。
产品 API · Deployment我们提供的产品控制面，包含定义与发布接口和 Runtime API。运行时命令通过 Rivet / Pi 执行，查询状态与输出事件使用 Actor 会话数据；RDS 仅保存产品配置和绑定。
计算 Worker Pod · Node.js + RivetKit多个 Actor 共享 Node.js 应用进程，每个 Actor 拥有独立 SQLite 数据库。Pi Durable 使用 actorSqlite(c.db)，SQL 在原生 SQLite 中执行；VFS 将页面读写和提交交给 Engine / WarpDrive。应用副本与 Engine 分别伸缩，不可信工具在沙箱中执行。
OpenSandbox 控制组件沿用已审查 OpenSandbox 版本。Python Lifecycle Server 默认单活；Go controller 可以多副本并选主。Server 调用 K8s API 创建 BatchSandbox / Pool，controller 调和 Pod；ingress-gateway 承担数据通道。
Rivet Engine 3 · StatefulSet ×3Rivet 3 当前为 Preview。Engine 负责 Actor 分配与路由，以及 WarpDrive 的磁盘副本、缓存和持久化；不是执行 Pi 的 Worker。提交经多数磁盘副本确认后再异步下沉对象桶。3.x 不再要求 PG / NATS。当前升级不允许混合版本，需全停维护；官方尚未验证备份桶恢复到全新集群。Engine 盘保留未下沉的已确认写入，不只是缓存。
ESSD 云盘阿里云 ESSD 是按官方块盘要求做的部署映射，尚未实测。官方生产建议每实例至少 100 GiB。不能多实例共享一个目录；跨可用区调度要匹配云盘拓扑。节点失效主要依靠 Rivet 副本恢复，不能等同于共享 NAS 重挂。
工具 Sandbox Pod ×N后台 Agent 跑完结束、保留产物为主。需我们实现 provider 与 run→sandbox→NAS目录绑定；领取预热沙箱执行，确认产物保存后销毁并补池。目录可见范围、首次视频读取与并发吞吐需 ACK 实测。
Pool / NAS 预挂载 · 已支持已支持：Pool 模板在预热时挂好 RWX PVC。候选方案：用 subPathExpr 按 Pod UID 预绑定独立目录；目录创建、权限和映射由我们适配并验证。领取时不改挂载，结束保留产物后销毁补池。Pool 请求仍不能追加 volumes；热池耗尽会排队或等待补充容量。
RDS PostgreSQL建议仅保存我们产品控制面的元数据。Pi 会话与执行进度由 Actor SQLite 保留，Rivet 3 不需要用这份 RDS 承载 Actor 状态。
阿里云 OSS · 待确认Rivet 3 支持 S3 兼容接口，但源码使用 ETag 条件写创建、更新协调记录。OSS 文档对 PutObject 的 If-Match / If-None-Match 有限制，不能仅换 endpoint 就宣布兼容。TOS 已有条件写文档与 Formless 接入，可作为后端候选；仍需验证寻址、真实 CAS 与故障恢复。MinIO 是另一备选，另有运维和许可评估。
阿里云 NASNAS 保存大视频和产物，临时渲染使用本地 scratch。共享 PVC 独立于任务生命周期；Pod 销毁后目录和产物保留，后续由平台清理。按 Pod UID 预绑定目录是候选适配方案，不能在领取时改挂任意旧 run 目录。ACK CSI、权限、RuntimeClass 可见性与视频 I/O 尚未实测。
ACR 镜像仓库建议将固定版本的镜像和构建产物推送国内 ACR，避免生产启动依赖公网 Docker Hub、npm 或 PyPI。OpenSandbox 已有国内 ACR 默认镜像；全套拉取尚未实测。
RAM / KMS凭证注入按组件能力接入；不能假定 Rivet 的 S3 客户端自动识别阿里 RRSA。对象桶凭证仅交控制组件，工具进程按业务授权获取所需权限。
VPC 出网模型思考和可信 API 调用发生在 Worker 一侧。按现有 VPC 网络配置模型出口；沿用现有模型服务与出网策略。
Pi 状态与 WarpDrive
Worker · Pi + 真实 SQLiteSqliteStorage.open(actorSqlite(c.db))。SQLite 真实执行 SQL，Pi Durable 保存对话、任务与执行状态；Worker 不需要先下载完整数据库。这里不包含工具进程 RAM 或 NAS 视频文件。
Engine · 调度 + WarpDrive热写入先落在多个 Engine 的磁盘上，而不是每次等待对象桶 PUT。Actor 的 SQL 数据库仍是独立的逻辑数据库；WarpDrive 管理底层卷和复制。ACK 云盘延迟、跨 AZ 网络和副本数会影响实际耗时。
对象存储 · 冷数据对象存储不只用于冷数据，也参与集群协调。对象桶故障时，已有热数据读写可能继续；冷数据唤醒和部分协调/控制操作会受影响，不能推断整个集群所有操作都正常。
celld + Pi Durable + OpenSandbox
每节点一个 Rust 进程提供 DO + SQLite，外部依赖少；需满足对象桶 CAS 语义，并验证 Pi 兼容与节点恢复。
阿里云 ALB建议用阿里 ALB Ingress 接入产品 API。ALB 是阿里云负载均衡产品，Ingress 是 K8s 路由规则。Rivet Engine 与 OpenSandbox 管理服务保留内网入口；长连接链路需配置超时。
产品 API · Deployment我们提供产品定义、发布与 Runtime API；内网 HTTP / RPC 调用 celld 的 Agent。产品元数据保存在 RDS，Pi 会话与执行状态保存在各 Cell SQLite。
Worker Bundle · 构建与发布这是构建发布步骤，不是常驻计算 Worker。celld deploy 用 esbuild 打包并写入共享桶，各 celld 节点加载发布包。官方 Pi 示例仍固定旧 PR 依赖；升级已发布 SDK、调整 PiHarness 初始化属于正常开发。迁移后的模型调用、SQLite 与生命周期行为在 celld 上做 POC。
OpenSandbox 控制组件沿用已审查 OpenSandbox 版本。Python Lifecycle Server 默认单活；Go controller 可以多副本并选主。Server 调用 K8s API 创建 BatchSandbox / Pool，controller 调和 Pod；ingress-gateway 承担数据通道。
celld Node Pod ×3 · StatefulSet（建议）每节点一个 celld 进程；没有独立 Engine 服务。每 Cell 一个 SQLite，Pi Durable 由 PiHarness 接入 DO 存储与生命周期。fleet 默认向其他节点 fsync 复制后确认，随后上传对象桶；无 follower 时等待桶持久化。StatefulSet 与三节点是本图部署建议，未做 ACK POC。
ESSD 云盘本地盘参与 SQLite 执行与节点日志恢复，不能视为可随意丢弃的缓存。跨节点副本与对象桶共同提供持久化，单节点模式等待桶确认。ESSD、PVC 和重启挂载是 ACK 部署建议，尚未实测。
工具 Sandbox Pod ×N后台 Agent 跑完结束、保留产物为主。需我们实现 provider 与 run→sandbox→NAS目录绑定；领取预热沙箱执行，确认产物保存后销毁并补池。目录可见范围、首次视频读取与并发吞吐需 ACK 实测。
Pool / NAS 预挂载 · 已支持已支持：Pool 模板在预热时挂好 RWX PVC。候选方案：用 subPathExpr 按 Pod UID 预绑定独立目录；目录创建、权限和映射由我们适配并验证。领取时不改挂载，结束保留产物后销毁补池。Pool 请求仍不能追加 volumes；热池耗尽会排队或等待补充容量。
RDS PostgreSQL这份 RDS 只属于我们自建的产品控制面。celld 自身不依赖 PG / Redis / 外部分配服务，长期状态与所有权记录使用对象桶。
阿里云 OSS · 原版直连有阻碍celld 0.6.3 自定义 S3 endpoint 强制 Path-style；OSS 仅接受 Virtual-hosted。celld 必须使用 If-None-Match 条件创建和 If-Match 条件更新，OSS 当前文档列为不支持。故原版不能当作开箱兼容；地址风格可改代码，但条件写需服务端等价原子语义，不能靠 HEAD 后 PUT。TOS 已有等价条件写文档，可优先验证其 S3 入口并适配 Virtual-hosted；Formless 的 Beehive 有参考实现。未做真实桶测试。
阿里云 NASNAS 保存大视频和产物，临时渲染使用本地 scratch。共享 PVC 独立于任务生命周期；Pod 销毁后目录和产物保留，后续由平台清理。按 Pod UID 预绑定目录是候选适配方案，不能在领取时改挂任意旧 run 目录。ACK CSI、权限、RuntimeClass 可见性与视频 I/O 尚未实测。
ACR 镜像仓库将固定版本的 celld 二进制及工具镜像构建并推入国内 ACR。Pi Worker Bundle 由 celld deploy 发布到对象桶，不是独立 Node.js 应用镜像。
RAM / KMS对象桶凭证只交 celld 与发布任务；不能假设 Rust S3 客户端自动使用阿里 RRSA。短期凭证映射与续期仍需接入验证。
VPC 出网Pi 思考和可信 API 工具在 celld 中执行，通过 VPC 出口连接模型。bash / ffmpeg / 浏览器等工具经我们实现的远程适配调用 OpenSandbox。
产品职责参考
绿框：职责覆盖（含适配） · 灰：外部补齐
Rivet
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 是正常接入开发，不作为选型阻塞。
工具沙箱文件和 shell 工具通过执行环境进入沙箱。
隔离 Runtime / Driver由外部组件补齐。
模型推理 / 可信 API由外部组件补齐。
NAS 大视频 / 工作目录 / 产物文件保存依赖执行环境；NAS 挂载需要 provider 适配，不由 Actor 状态自动兜底。
OpenSandbox
UI / API / 消息 / Webhook由外部组件补齐。
Agent 托管控制面由外部组件补齐。
Agent 定义与发布由外部组件补齐。
Environment 定义支持镜像与资源规格；普通 K8s 后端传递 requests / limits。
Workspace 模板与绑定由外部组件补齐。
Agent Runtime API由外部组件补齐。
Trigger / Cron / 批量派发由外部组件补齐。
Session / Run / subagent由外部组件补齐。
Agent Harness由外部组件补齐。
会话与执行状态由外部组件补齐。
环境构建 / 镜像与模板由外部组件补齐。
沙箱冷启动 / 热池已支持：普通 K8s Pool 预热与模板预挂 PVC；正常开发包括领取、目录关联与销毁补池；POC 测热池命中/耗尽延迟。暂停恢复本期降权。
工具沙箱提供命令、文件与进程接口；ffmpeg / 浏览器依赖需装入镜像。
隔离 Runtime / Driver接入具体 RuntimeClass / 后端；NAS 和快照兼容性需逐一核验。
模型推理 / 可信 API由外部组件补齐。
NAS 大视频 / 工作目录 / 产物已支持：普通 K8s PVC/subPath、Pool 模板静态挂卷；需适配按 Pod 预绑定目录和产物发布。待测 ACK+NAS+隔离 runtime 的可见范围与视频 I/O。领取时不能追加卷。
eve
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 需适配。
工具沙箱通过沙箱后端运行工具。
隔离 Runtime / Driver由外部组件补齐。
模型推理 / 可信 API由外部组件补齐。
NAS 大视频 / 工作目录 / 产物工作文件默认留在会话容器；独立持久 Workspace 需要后端补齐。
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 另行绑定镜像与资源。
Centaur
UI / API / 消息 / Webhook提供 API、Slack 与 Console。
Agent 托管控制面提供团队 Agent 平台；业务入口和模板仍需适配。
Agent 定义与发布提供 Agent 与 harness 配置；完整产品契约按业务扩展。
Environment 定义支持镜像、资源、卷和 RuntimeClass。
Workspace 模板与绑定通过持久卷保存工作目录和会话；初始文件模板按业务补齐。
Agent Runtime APIAPI 提供会话与执行管理；统一 Runtime API 需要适配，终止与恢复语义逐项核验。
Trigger / Cron / 批量派发有消息触发和持久执行；通用 Cron 与批量额度需核验。
Session / Run / subagent管理消息、会话和执行；subagent 业务契约仍需核验。
Agent Harness本产品 harness 在沙箱内运行；已有 Pi RPC 适配，已审查文档限定 Slack 选择。
会话与执行状态PostgreSQL 保存消息与执行事件；原生会话依赖持久卷。
环境构建 / 镜像与模板由外部组件补齐。
沙箱冷启动 / 热池使用 SIG Agent Sandbox 控制器。
工具沙箱工具与完整 harness 位于执行沙箱。
隔离 Runtime / Driver隔离依赖配置的运行时。
模型推理 / 可信 API由外部组件补齐。
NAS 大视频 / 工作目录 / 产物PVC 保留工作与会话；暂停不等于内存快照。
Claude Managed Agents
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，与工具沙箱分离。
会话与执行状态平台托管会话和执行状态。
环境构建 / 镜像与模板平台准备与管理执行环境；底层模板构建实现未公开。
沙箱冷启动 / 热池平台提供沙箱生命周期。
工具沙箱托管工具执行沙箱。
隔离 Runtime / Driver平台提供隔离；底层内核实现未公开。
模型推理 / 可信 APIAnthropic 提供 Claude 模型；自定义工具的第三方 API 仍由外部服务提供。
NAS 大视频 / 工作目录 / 产物平台托管工作文件和附件；不等于分支 FS 或 NAS 大视频直挂能力。
Agent Substrate
UI / API / 消息 / Webhook由外部组件补齐。
Agent 托管控制面由外部组件补齐。
Agent 定义与发布由外部组件补齐。
Environment 定义Actor / WorkerPool 定义镜像与执行规格。
Workspace 模板与绑定由外部组件补齐。
Agent Runtime API由外部组件补齐。
Trigger / Cron / 批量派发由外部组件补齐。
Session / Run / subagent由外部组件补齐。
Agent Harness由外部组件补齐。
会话与执行状态由外部组件补齐。
环境构建 / 镜像与模板管理运行模板与快照；CI 镜像构建仍由外部完成。
沙箱冷启动 / 热池管理 Actor 激活、预热容量、快照与恢复。
工具沙箱承载镜像内的执行进程；不负责 Agent 工具契约。
隔离 Runtime / Driver接入隔离 worker runtime；按部署后端核验。
模型推理 / 可信 API由外部组件补齐。
NAS 大视频 / 工作目录 / 产物保存 RAM 与根文件系统快照；NAS 外部卷与分支 FS 需另外核验。
Perplexity SPACE
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 仍在孵化。
工具沙箱提供独立命令执行与数据通道。
隔离 Runtime / Driver基于 Firecracker microVM；官方安装路径涉及 KVM、tun、loop 与 btrfs，需要节点配置。
模型推理 / 可信 API由外部组件补齐。
NAS 大视频 / 工作目录 / 产物根文件系统属于 VM 状态；ACK NAS 的直挂、权限与恢复尚未验证，不据此判定不支持。
LayerFS
UI / API / 消息 / Webhook由外部组件补齐。
Agent 托管控制面由外部组件补齐。
Agent 定义与发布由外部组件补齐。
Environment 定义可选 Docker 镜像；没有完整 CPU / 内存资源规格。
Workspace 模板与绑定从同一快照分叉，未修改内容共享，各分支独立记录文件增量；支持提交与合并，对话 fork 需 Harness 配对。
Agent Runtime API由外部组件补齐。
Trigger / Cron / 批量派发由外部组件补齐。
Session / Run / subagent由外部组件补齐。
Agent Harness由外部组件补齐。
会话与执行状态由外部组件补齐。
环境构建 / 镜像与模板由外部组件补齐。
沙箱冷启动 / 热池自带单机 Docker 沙箱管理；不提供集群调度。
工具沙箱可在挂载 Workspace 后 exec / bash。
隔离 Runtime / Driver由外部组件补齐。
模型推理 / 可信 API由外部组件补齐。
NAS 大视频 / 工作目录 / 产物保存代码、依赖、缓存、忽略文件的历史，不保存进程或内存。Store 依赖同一 Linux 内核和本地磁盘，不能直接当成 NAS 上的多节点分支 FS。
共享基础快照 C0LayerFS Init 纳入整个项目目录，不受 Git ignore 过滤。fork 记录起点，不复制文件；内容按块压缩去重。图中的 C0 是不可变的快照引用，分支 A/B 从同一状态出发。
Agent A · 分支 A每个 Workspace 有自己的可写 overlay；提交保存新的文件树与内容增量。Δ 是逻辑上的文件增量，包括二进制内容，不限于文本 diff。父分支之后的新修改不会自动进入该分支。
Agent B · 分支 B与分支 A 共用未改动内容，但写入互不影响。分支引用的是 fork 时的快照；需要其他分支的更新时显式合并。
提交检查点 / 选择或显式合并LayerFS 保存提交与文件历史。合并和发布是显式操作，不会自动选择最优结果，也不自动解决所有文件冲突。对话 fork 与 Workspace fork 的对应关系仍由 Harness 管理。
参考资料
- Claude Managed Agents
- Harness / Sandbox 分离
- Agent Substrate
- Actor / 快照恢复
- SPACE
- microVM 控制面
- LayerFS
- Workspace 分叉与合并