# 进阶画风样本组:多图交叉提取与纯文本迁移验证 ## 目标与边界 本功能只对素材根分类“风格”开放。服装、鞋袜、配饰、构图等普通与进阶素材继续使用单图导入,不改变现有接口语义。 一个进阶画风样本组接收 2~8 张同画风图片(推荐 3~6 张),将每张图片拆成完全独立、同时执行的视觉识别任务;全部可用结果完成后,再由交叉分析任务同时读取原图与逐图报告,分离共同画风、可变特征和内容污染。验证阶段不向生图模型传递任何源图,只把统一画风胶囊应用到与源样本完全不同的角色、场景和构图,以验证画风的迁移能力,而不是源图复刻能力。 最终仍封存为一个 `advmat_...` 进阶素材目录项。现有素材目录、衣橱、详细角色工作流继续通过统一 Material 合约使用它;旧的单图进阶素材不需要迁移。 ## 用户流程 ```text 选择“风格” -> 上传 2~8 张样本 -> 每张样本创建独立识别任务并同时派发 -> 成功样本达到至少 2 张 -> 交叉模型同时读取全部有效原图与逐图报告 -> 生成共同画风、可变项、内容污染与异常样本报告 -> 自动规划三个与源样本语义显著不同的验证场景 -> 三个纯文本生图任务同时派发(无 input_images / image) -> 人工对照三项迁移结果 |-- 接受 -> 封存一个高优先级进阶画风 `-- 调整 -> 重建统一胶囊 -> 使用同一组场景重新并行验证 ``` ## 并行任务与屏障 ### 单图识别 - 每张源图拥有独立 `source_id`、`task_id`、状态、超时、重试次数、错误和识别结果。 - 同一组内的 2~8 个识别任务一次性入队;Worker 不串行等待,调度并发上限默认等于组内图片数,硬上限为 8。 - 任何一张失败都不得取消或超时其他任务,也不得共享计时器。 - 失败样本可以单独重试或排除;成功样本不少于 2 张时允许用户继续。 - 交叉分析通过数据库屏障触发:所有未排除任务进入终态,且成功数不少于 2;重复回调必须幂等,最多创建一个交叉分析任务。 ### 验证生成 - 默认生成 `portrait`、`fullbody`、`novel_scene` 三个验证案例。 - 三个案例分别创建任务并同时派发,每个案例拥有独立超时、重试、取消和错误。 - 验证批次只在全部未排除案例进入终态后进入人工审核;单例失败可以单独重试。 - 所有耗时接口立即返回“已入队”,前端通过导入详情轮询状态。 ## 画风交叉分析 交叉模型输入: - 全部有效原图; - 每张图片的结构化识别报告; - 每张图片的内容摘要; - 用户补充的画风要求; - 明确的“只抽取可观察画风、不继承内容”约束。 交叉结果至少包含: - `consensus_style`:多图稳定共同特征; - `variable_style_features`:部分样本存在的弱特征; - `source_content_features`:人物、服装、姿势、道具、场景与构图内容; - `content_leakage_exclusions`:正式提示词必须排除的内容污染; - `outlier_source_ids`:疑似异画风样本; - `representative_source_ids`:按风格强度、内容差异和污染风险选择的 1~3 张代表图; - `consensus_confidence` 与逐特征证据; - `compact / standard / detailed` 三档统一画风胶囊。 共同特征的默认分级: - 支持率不低于 60% 且置信度达标:核心画风; - 支持率 40%~60%:可变或弱画风; - 支持率低于 40%:不进入核心胶囊; - 人物身份、服装、姿势、道具、文字、背景主体:进入内容污染或禁止继承项; - 近重复图片降低证据权重,避免重复样本放大偶然特征。 ## 纯文本异角色异场景验证 验证规划器先根据 `source_content_features` 生成三个语义距离显著的内容案例。案例必须改变尽可能多的内容维度:年龄、性别或物种、服装、姿势、镜头距离、室内外、背景、道具和构图。 每个案例分离保存: - `content_prompt`:只描述新角色与新场景; - `style_prompt`:统一画风胶囊; - `final_prompt`:由后端可追踪地合并两者; - `negative_prompt`:画风禁止项与内容污染排除项; - 路由、模型、seed、输出图、用量与错误。 生图请求必须满足: ```json { "input_images": [], "image": [] } ``` 验证输出可以由 Vision 模型依据统一画风指纹进行辅助审核,但不得以人物是否像源图作为指标。审核维度包括线条、着色、阴影、色彩规律、边缘、高光、纹理、媒介感、细节密度和内容污染。自动评分只作参考,不能自动封存。 ## 人工调整与版本一致性 - 调整说明不得只追加到顶层 prompt。 - 每次调整必须生成新的共识版本,并同步重建三档胶囊、负向词与内容污染排除项。 - 使用同一组三个验证案例重新生成,便于前后对比;旧版本和旧验证结果永久保留。 - 封存时必须引用当前已审核的共识版本,杜绝“验证用新提示词、正式生图仍用旧胶囊”。 ## 数据模型 在现有 `advanced_material_imports / advanced_material_validation_attempts / advanced_materials` 之外增加风格专用子表: - `advanced_style_sources`:源图、缩略图、排序、主参考、排除状态、独立任务与识别结果; - `advanced_style_consensus_runs`:交叉分析输入摘要、共同画风、可变项、内容污染、代表图、统一胶囊和版本号; - `advanced_style_validation_cases`:一个共识版本下的三个异场景案例、独立任务、输出图与审核结果。 导入主记录通过 metadata 保存 `workflow_kind=style_set`、当前共识版本和批次状态。`advanced_materials.source_image_uri` 继续保存主参考图以兼容旧消费者,完整源图与最多三张代表图通过关联数据和可信 metadata 暴露。 ## 接口与兼容策略 保留所有现有单图接口,增加风格组接口: - `POST /advanced-material-imports/style-set/upload` - `POST /advanced-material-imports/{import_id}/style-sources/{source_id}/retry` - `POST /advanced-material-imports/{import_id}/style-sources/{source_id}/exclude` - `POST /advanced-material-imports/{import_id}/style-consensus` - `POST /advanced-material-imports/{import_id}/style-validation-cases/{case_id}/retry` - `POST /advanced-material-imports/{import_id}/validation-attempts`(兼容入口;确保三场景批次存在) - `POST /advanced-material-imports/{import_id}/attempts/{attempt_id}/reject`(携带调整说明并创建新共识版本) - `POST /advanced-material-imports/{import_id}/attempts/{attempt_id}/accept`(封存当前已审核版本) 服务端按 `material_categories` 的规范名称确认“风格”,不信任前端标签。非风格分类上传多图必须返回明确校验错误。旧单图进阶素材仍走原接口和原状态机。 ## 下游应用 - 快速角色:使用统一画风胶囊,不自动发送源图,维持当前轻量路径。 - 详细角色工作流:使用 detailed 胶囊;只有提供方明确支持参考图时才选择主参考及最多两张代表图。 - 适配器不支持原生参考角色/权重时,优先只发送主参考图,避免人物、服装和构图污染。 - 验证图永不进入普通图库、角色候选池或正式参考图集合。 ## 开发队列与验收状态 - [x] P0:新增风格样本、共识版本和验证案例迁移、DTO 与仓储。 - [x] P0:后端只允许“风格”使用 2~8 张,多图上传原子落盘,失败时清理新文件。 - [x] P0:逐图任务独立入队、独立超时/重试/错误,批次同时派发并提供幂等屏障。 - [x] P0:交叉分析同时读取全部有效原图和逐图报告,生成带证据的统一画风结构与三档胶囊。 - [x] P0:验证规划生成三个与源内容显著不同的案例;生图请求不得携带任何源图。 - [x] P0:三个验证案例独立并行、可单独重试,失败不影响其他案例。 - [x] P1:人工调整创建新共识版本并同步重建胶囊;封存只能引用当前已审核版本。 - [x] P1:统一目录继续输出一个 `advmat_`,可信 metadata 携带代表源图但不暴露伪造优先级。 - [x] P1:前端仅在选择“风格”时启用多图上传、排序、主参考、排除和逐图状态。 - [x] P1:前端展示当前共识版本、共同画风、可变项、内容污染、异常样本和三案例验证。 - [x] P2:备份恢复、孤儿媒体、成本预算、统计与日志覆盖新增表和文件。 - [x] P2:迁移、仓储、服务、Worker 恢复、权限、路由、契约、类型检查和深夜模式测试。 - [x] P2:完整后端测试、前端契约、类型检查、生产构建和 `git diff --check` 全部通过。 ## 验收标准 1. 非风格分类无法创建多图组;旧单图进阶流程无回归。 2. 风格组支持 2~8 张,所有单图识别任务同时进入队列且无共享超时。 3. 单图失败可单独重试、排除;至少两张成功后可以交叉分析。 4. 交叉结果能追溯每个核心特征来自哪些图片,并分离源内容污染。 5. 三个验证案例的角色、场景和构图与源样本显著不同,且 provider 请求没有源图。 6. 三个案例独立并行,任一失败不会覆盖其他任务状态。 7. 人工调整后统一胶囊版本发生变化,封存素材使用新胶囊。 8. 最终只产生一个进阶画风素材,验证图保持隔离。 9. 旧数据库可平滑迁移,插件重启可恢复识别任务但不会自动重复付费验证。 10. 全量自动化测试与静态构建通过,测试过程不调用真实付费模型。