Sandbox Jobs 与 Browser Runtime
Sandbox Jobs 让插件把浏览器渲染、PDF/PPTX 导出和文档转换交给短生命周期、受资源限制的隔离环境。Chromium 由 Xpert 的统一 Browser Runtime 提供，不安装在 API 容器中，也不复用当前智能体会话的 Sandbox。 Presentation Studio 的 PDF/PPTX 导出是首个使用该能力的产品功能。用户会看到什么
- 用户从 Workbench 或智能体发起导出。
- 插件创建业务导出记录，浏览器专用任务池开始排队。
- 有容量后，Xpert 启动一次性的 Browser Runtime Sandbox。
- 插件的 Presentation Action 与平台 Chromium 在 Sandbox 内组合执行。
- Xpert 校验 PDF/PPTX，写回当前 Project 或 Xpert Workspace。
- 导出记录显示下载信息，临时容器立即回收。
与智能体 Sandbox 的区别
Sandbox Jobs 不提供任意 shell。插件只声明 Action 名称和版本，不能传入镜像、命令、entrypoint、environment、Docker 参数或宿主路径。
平台与插件如何分工
因此插件不需要自行维护 Docker image。Browser、字体和安全基线由平台复用；插件只发布自己的业务 Action。新的 Office、Python 或 Agent Sandbox Runtime 可以沿用同一 Runtime Suite 管理方式。
Presentation Studio 可用性
HTML 导出不依赖 Browser Runtime，PDF/PPTX 则根据 Action health 分别显示可用性：
平台异常时应保持 HTML 可用，不要在 API 容器内临时下载 Chrome。
导出请求如何被接受
Workbench 和服务端导出接口会在创建浏览器导出记录或队列任务前组合两项独立检查：- Sandbox Jobs
getActionHealth()检查 Action、Runtime Definition、API 本地 Binding、不可变 artifact、Provider 和 Runtime manifest。 - Managed Queue
getExecutionPoolHealth({ executionPool: 'sandbox-browser' })检查浏览器执行池是否有存活 consumer。
queued、容量 waiting、starting、running，最终到达 succeeded、failed 或 cancelled。容量等待不消耗重试次数；幂等重试会返回既有成功结果或重新附着到运行中任务，只有新的 attempt 才能重新选择健康的 Runtime Binding。
默认启用与生产部署
- 通过 Xpert version release 发布 Sandbox Runtime Suite。
- Pro 在 API 进程同时注册专用
DockerSandboxRuntimeProvider与独立的交互式DockerSandboxProvider。OSS 可安装其他公开 SPI Provider 发行物。 - Provider release 使用随包生成的不可变 Runtime Suite lock，不要求用户配置 image/profile/provider。
- 检查 Browser Runtime、Presentation Action、API 本地 Provider health 和 execution pool health。
RUNTIME_UNBOUND。Pro 在同一个 Docker Sandbox 模块中分别维护 DockerSandboxProvider 与 DockerSandboxRuntimeProvider 两个策略类并在 API 同时注册；两者共享 Docker engine 层，不共享生命周期契约。xpert-plugins 不包含第二套 Docker 实现 package。生产 artifact 由 Pro 模块的 runtime-suite.lock.json 固定为 repository@sha256:<digest>；不接受 latest、main 或版本 tag，也没有 SANDBOX_BROWSER_RUNTIME_IMAGE 配置项。
开源版与 Pro 版
平台不会以内置本地进程 Provider 代替生产隔离。OSS API 不挂载 Docker socket；Pro 或社区 API 只获得其已安装 Provider 所需的引擎访问权限。PDF/PPTX 是默认健康驱动的能力；条件未满足时菜单展示具体原因和修复建议，而不是静默灰掉。
RUNTIME_UNBOUND 表示 API 执行器无法提供兼容 Binding。
Sandbox Action bundle hash mismatch 不是运行时配置项缺失。它表示安装后的 Action 文件与 manifest 记录的 hash 不一致：构建方应让 Action 自有依赖位于 bundle/runtime-modules 等普通目录，禁止嵌套 node_modules，并在发布前实际执行 npm pack、解压 tarball、从解压内容复算 hash。运维侧升级或重新安装修复后的 Presentation Studio package，再重启 API 以刷新 Action Registry；无需增加 image、profile、Provider 或 CHROME_PATH 环境变量。
资源、容量和安全
Browser Runtime 默认使用 2 CPU、4 GiB 内存、1 GiB/dev/shm、4 GiB 临时空间，任务超时 300 秒，容器 hard deadline 360 秒。
容器以非 root、只读根文件系统、drop all capabilities、no-new-privileges 和默认禁网运行。只有当前 Job 的 /workspace 可写；插件目录和宿主 node_modules 不会挂载。
容量默认限制为全局 20、单租户 4、单用户 2。达到上限时任务保持 waiting，不会创建半初始化容器，也不会消耗业务重试次数。
文件、重试与取消
队列只传递业务标识。Handler 从业务记录读取固定版本或 snapshot，并使用 Workspace Files portable references 传递素材；平台校验 tenant、size、SHA-256 和路径。输出校验成功后返回 portable references，不把 buffer/base64 写入队列。 相同业务 ID 与不可变 checksum 会复用成功结果或重新附着正在运行的 Job。容量服务、Provider 启动、浏览器启动、超时和 OOM 属于可重试故障；Action/Profile/版本、输入和输出结构错误不重试。 用户取消时，平台同时取消 Managed Queue 任务和已启动的 Sandbox Job。成功、失败或取消后容器与临时 Job Volume 都会回收；遗留任务由 cleanup scheduler 补偿。当前边界
- v1 只允许 system-level 插件声明可执行 Action。
- 每个 PDF/PPTX 导出使用新的短生命周期容器，不跨 Job 或租户复用。
- 当前单 Job 输入和输出分别限制为 350 MiB。
- 生产环境不会在 Job 启动时安装 npm 包或下载浏览器。
CHROME_PATH和本地 backend 仅用于 development/test。