SuperAPI AI 工具集

blender-background-jobs

设计与创作

查看项目

更新于 10-15 21:47

技能介绍

用途:在渲染、导出或缓存烘焙会阻塞前台工作,或任务要求断点恢复与逐帧校验时使用。快速且必须立即观察结果的操作继续走对应前台技能。提交作业前需已有已提交的 sceneRevision + snapshotId、批准的输出根目录和不可覆盖约束,并明确任务类型、帧范围、格式、超时与磁盘预算。

主要能力:按种类路由,EXPORT 与 RENDER_STILL 还会用到 blender-render-compositing,BAKE_POINT_CACHES 还会用到 blender-simulation。用 RENDER_ANIMATION_FRAMES 生成持久化 PNG 或多层 EXR 序列;仅当来源 FrameSequenceReceipt 的帧哈希完整时才用 COMPOSE_VIDEO,它生成独立的 H.264 收据且不重新渲染 Blender。

使用方式:先保存不可变快照,提交作业并记录 job ID、快照哈希、清单哈希与输出目录,然后轮询至终态。子进程只能在自身作业目录内写入,前台可继续编辑但作业仍绑定已提交快照。恢复时先做检查,只有显式 job.resume 才继续;job.recover 可将丢失任务标记为 interrupted 但不会重启。已验证帧保持不动,仅替换缺失或哈希错误的帧。

验证:核对终态、退出码、快照哈希、帧区间、逐帧哈希、文件大小与媒体探测结果;视频合成还需证明输入序列完整且时长、帧率、尺寸符合约定。

限制:后台成功不等于画面质量被接受,也不授权上传、发布、付费或 Video Factory 编排;不得写出批准目录,不自动重启未知状态任务。常见问题包括子进程消失时标记 interrupted 并保留日志与已验证帧、单帧损坏按哈希定位并只重做该帧、磁盘不足或路径越界时立即停止并报告实际路径与空间需求。