跳转到内容

产物下载与迁出

调用 artifact_publish,传入工作区内的相对文件路径。等待 operation 成功后,在 User Dashboard 的 Artifacts 列表中下载结果。产物存于私有Cloudflare R2,不能匿名访问。 预览桶为 mogick-sandbox-preview-objects;产物在 artifacts/,保存点在 checkpoints/, 日志在 logs/,本地输入缓存在 relay-cache/。普通工作文件先位于运行中的容器, 执行成功不等于已经保存,须等待checkpoint成功或发布产物。

下载需要本人有效 Clerk 会话或 API key。实例停止后,产物仍可下载。默认产物有效期为 30 天。 文件以附件形式返回,服务会提供 SHA-256,下载后应核对哈希。

调用 workspace_export 生成标准 workspace.tar.gz。归档包含 project/ 下的普通工作文件 和 manifest.json,后者记录路径、字节数和 SHA-256。

在普通 Linux 环境中迁入时:

  1. 核对下载归档本身的 SHA-256。
  2. 检查成员路径,不接受路径穿越、符号链接或特殊文件。
  3. 按 manifest 核对成员集合、文件大小和哈希。
  4. 在准备好的运行环境中,通过解释器复跑任务。

已验证无需 Cloudflare API 或专用恢复 SDK 的 Linux 复跑。归档不是完整镜像备份, .git、可执行位和系统安装不在当前恢复范围内。

其他用户无法下载你的产物;无权访问和资源不存在都返回 NOT_FOUND。 Admin Dashboard 只提供运行元数据,不提供用户产物内容下载。