AnyImage/openspec/specs/ai-input-validation/spec.md

ai-input-validation Specification

Purpose

TBD - created by archiving change unify-ai-input-validation. Update Purpose after archive.

Requirements

Requirement: Shared input format validation

AI 输入 SHALL 使用公共格式规则，在 Blender 提交前与后端处理前校验实际输入路径。支持图片为 JPG/JPEG/PNG/WEBP，视频沿用当前 MP4/MOV/AVI/MKV/WEBM/M4V/MTS/MPG/MPEG，扩展名匹配忽略大小写。

Scenario: Unsupported file in image edits

• WHEN Remove BG 与 Upscale 使用同一个存在的 .tiff 普通文件，且环境和模型已就绪
• THEN 两者在提交 Job 前取消，展示相同格式提示，包含 .tiff 和分类排序的支持格式

Scenario: Direct backend input

• WHEN 后端直接收到不支持格式的文件或无扩展名文件
• THEN 使用与前端相同的格式提示规则，无扩展名显示 (no extension)

Scenario: Supported uppercase extension

• WHEN 实际输入为存在的 .PNG 或 .MP4 文件
• THEN 通过对应图片或视频格式校验

Scenario: Model image validation

• WHEN BEN2 单帧入口收到不支持的图片扩展名
• THEN 使用公共格式提示的图片子集，并与公共图片支持集合一致

Requirement: Distinct input failure reasons

系统 SHALL 区分缺失路径、不支持格式、目录无有效帧和解码失败；提示 SHALL 适用于 Image Empty 和 Image Texture，解码异常转换 SHALL 限定于读取边界。

Scenario: Missing source file

• WHEN Image Empty 或材质 Image Texture 的源图片或视频文件不存在
• THEN 提示缺失的 source image/video file 及路径，不将原因报告为格式不支持

Scenario: Invalid encoded data

• WHEN 支持扩展名的文件内容无法作为对应图片或视频解码
• THEN 报告无法读取的媒体类型及路径，并保留底层异常供诊断

Requirement: Explicit frame selection

系统 SHALL 在复制 Blender 序列前校验图片格式；通用目录 SHALL 仅收集支持的图片，保持现有排序及帧范围规则。

Scenario: Unsupported Blender sequence

• WHEN Blender 源序列使用 .exr 扩展名
• THEN 复制前提示不支持的图片格式，不创建临时帧目录

Scenario: Mixed directory

• WHEN 通用输入目录包含 JPG、PNG、TXT 和 EXR 文件
• THEN 仅 JPG 与 PNG 参与处理，前后端按相同规则选择并保持原帧范围语义

Scenario: Empty supported frame set

• WHEN 通用目录为空或只有不支持的文件
• THEN 提示无支持的图片帧、目录路径及支持的图片格式

Requirement: Validate prepared media

系统 SHALL 校验实际提交的文件，保持各功能自身的媒体类型、尺寸和比例约束。

Scenario: Packed image exported as PNG

• WHEN 一个名称带 .exr 的 packed Image 经现有流程成功导出 PNG
• THEN 按导出的 PNG 校验，不按源名称拒绝

Scenario: Feature restriction

• WHEN 输入通过公共格式校验但不满足 Depth Plane 的静态图限制或 Upscale 的尺寸限制
• THEN 仍按对应业务原因取消，不报告为格式不支持