Omni 传输守卫与缓存

控制上传限制、派生预算、降质披露和临时文件清理。

omni 实验分支把主动预处理与强制传输守卫分开。即使没有固定策略，超过最终上传限制的媒体仍需降质；处理成功也不代表原始质量完整保留。

强制守卫

默认 image-downsample、video-downscale、audio-downsample 三条策略分别调用对应降采样工具。可整条覆盖，不可删除；合并后必须继续覆盖 image、video、audio。

守卫不能声明 when，因为触发条件就是传输超限；output.source 必须为 omit，不能把已知超限的源文件留在最终集合。最多执行 maxTransportPasses 轮，仍不符合限制时用媒体省略说明替代。

omni.processing.transportGuard.maxUploadFileBytes 不得超过 1GiB。这是实验配置的上界，并非所有模型、区域或上传接口都承诺接收 1GiB；实际服务端仍可因更低限制拒绝，触发降质重试。

字段位于 omni.processing.limits。大视频可能同时生成音轨、片段和多张图，派生总量可能超过源文件本身体积。预算耗尽阻止新派生，不追溯撤销已经提交的投递；不要把它当作精确的模型费用硬上限。

媒体降质标记说明原尺寸、时长到产物的变化及丢失信息；媒体转写标记附文本证据；媒体省略标记说明没有发送原资源。服务端超限导致再次处理时还会标出重试轮次。

这类说明应紧邻对应产物，使模型能区分完整音轨、转写文本、稀疏帧与截取片段。转写不保留所有语气或非语音细节，裁剪以外的区间不能从单个片段推断。

派生产物放在 .qwen/omni/objects/sha256/<xx>/<hash>.<ext>。降质缓存依据源哈希和策略身份复用已有结果，改变策略可能需要重新派生。

上传缓存按文件哈希、上传模型、endpoint 和 key 隔离。omni.delivery.upload.urlTtlHours 最多 48 小时；只改变推理地址不会自动使上传缓存失效。临时 oss:// URL 复用不等于推理调用免计费。

失败调用的暂存残留移到 quarantine// 并带 reason.json，按保留天数和体积预算惰性清理。崩溃后未提交的 staging 超过一小时宽限窗才回收，因此工具超时必须小于该窗口。

启动 OmniPolicyConfigError 先查策略字段、禁用工具、无下游的 reprocessMedia 和守卫覆盖。处理中超时则检查工具参数、文件规模、墙钟预算与外部模型；有成功产物也要查转写内嵌的失败段。

上传拒收或速率限制与本地转码不是同一问题。先读媒体省略和重试说明，确认实际送达了哪些证据，再决定重试或进一步裁剪。官方案例的成功次数、速度和费用不能推广为任何媒体的保证。