🎨 素材管线生成器

1. 目标与非目标

2. 总体架构

3. 一单素材怎样走完

1. 创建 brief：包名、用途、风格、类型、数量、画布、视角、光线、调色板、授权、透明背景要求。
2. 冻结风格 DNA：先生成 4–8 张候选；选中后锁 style prompt、negative prompt、seed family、palette 和构图规则。
3. 展开 shot list：把“20 个道具”拆成 20 个有稳定 ID 的 item，单项可重跑。
4. 生成原图：保留模型原始响应；后续产物从原图派生。
5. 抠图：主体 mask → alpha matte → 去色边 → 小孔修复 → 阴影策略 → 透明 PNG。
6. 派生：标准画布、缩略图、1x/2x、WebP 预览、可选 sprite sheet。
7. 自动质检：文件、像素、边缘、视觉、一致性、授权六道闸。
8. 失败回炉：按原因回到必要步骤；边缘坏只重抠，主体缺失才重生成。
9. 人工抽检：首包全检；稳定后抽样，低置信项强制检。
10. 原子发布：先写 staging，完整校验后复制到正式前缀，最后写 manifest；manifest 出现才代表包可见。

4. 抠图程序

source.png
 → foreground segmentation
 → trimap / alpha matting
 → edge color decontamination（去白边/绿边）
 → remove islands + fill tiny holes
 → preserve soft shadow（按素材规格）
 → crop bbox + safe padding
 → standard transparent canvas
 → asset.png + mask.png + debug_edge.png

具体阈值必须用真实素材集校准；蓝图只钉测量方法，不把未测数字写成永恒真理。

5. 六道质量闸门

PASS 自动通过REVIEW 低置信人工看RETRY 可自动修复REJECT 规格或权利问题

6. 状态机与重试

DRAFT → PLANNED → GENERATING → CUTTING_OUT → DERIVING → QA
                                              ├→ APPROVAL → PACKAGING → PUBLISHED
                                              ├→ RETRY_QUEUED → 对应步骤
                                              └→ REJECTED / CANCELLED

• 每一步使用 job_id + item_id + stage + input_hash 做幂等键；重复消息不得重复收费或发布。
• 网络/限流：指数退避 + jitter；模型内容失败：改提示词/种子；结构失败：只重跑处理步骤。
• 单 item 最多有限次自动回炉；超出转人工，不无限烧钱。
• 取消只阻止后续步骤，保留证据和成本。
• 死信队列记录最终错误，不把失败伪装成“素材库为空”。

7. 数据模型

数据库是生产过程账本；R2 manifest 是发布事实。两者职责不同，不构成手抄镜像。

8. manifest v1 合同

{
 "schema_version":1, "id":"neon-ui-v1", "name":"Neon UI", "version":"1.0.0",
 "style":"neon", "types":["ui","sprite"], "license":"HOOP-generated",
 "provenance":{"generator":"pipeline","job_id":"...","created_at":"..."},
 "files":[{"id":"button-primary","path":"ui/button-primary.png","kind":"ui",
   "width":512,"height":256,"sha256":"...","anchor":[0.5,0.5],
   "tags":["button","primary"]}]
}

• 现有列表端点仍可只读 name/style/types/license；新增字段向后兼容。
• 文件数继续由存储层数出并与 manifest 比对，manifest 不自报没人核的数字。
• manifest 最后写入：它是发布提交点，半包绝不能提前出现在 Workshop。

9. API 与事件

10. Workshop 产品界面

11. 安全、权限与版权

• 模型与 R2 凭证只在服务端保险箱使用；worker 拿短时、限范围凭证。
• 上传内容做 MIME/魔数双验、像素炸弹与大小限制、恶意元数据清理。
• 生产前缀仅 Packager 可写；生成 worker 只能写 staging。
• 每次发布保存操作者、manifest hash、文件 hash；同 pack/version 不静默覆盖。
• 人物照片需肖像权；品牌、已知角色、名人进入人工审核。
• 删除生产包走下架/墓碑流程，不能裸删对象。

12. 可观测性与成本闸

• 任务创建给预算预估；80% 警告，100% 停止新生成并转人工。
• prompt/原图按保留策略清理，QA、hash、成本和发布案底长期保留。
• 告警：队列积压、连续 provider 失败、发布后端点未出现、manifest/file hash 不符。

13. 测试与验收

1. 单元：状态转换、幂等键、manifest 校验、阈值判定、失败分类。
2. 契约：每个 provider adapter 用固定样本，返回格式变化立即红。
3. 图像 golden：普通边缘、头发、玻璃、烟雾、阴影、白底、复杂底。
4. 故意红：空 PNG、全不透明背景、断肢、白边、坏 manifest、少文件必须被拦。
5. E2E：建包→生成→抠图→QA→批准→R2→现有端点出现→裸浏览器游戏加载。
6. 故障注入：429/超时、worker 中途死、重复消息、R2 写一半、发布后读延迟。

14. 分刀开工清单