seaislee1209andClaude Opus 4.8
44e90233ff
后端:
- 新增 Model(模特)团队级实体:形象图+三视图+声线(声线尾期),官方模板标签,软删
- Asset.Category 枚举一次加全(model_portrait/tri_view/voice/model_tryon/platform_kit/free_create/storyboard),逐期接线
- 送审范围 person → REVIEW_CATEGORIES{person,tri_view,storyboard}(review.py + adminpanel 队列),图片趴不送审;当前行为不变(forward-compat)
- /api/models/ ModelLibraryViewSet:本团队∪官方模板、官方/我的 tab、真人上传、软删(官方不可删)、跨团队资产引用防越权
- backfill_models 命令把历史成套模特(kind=model + 项目流命名配对)归集成 Model,dry-run 默认
前端:
- 左菜单新增「模特库」顶级入口(person 图标)+ 路由 /models
- 模特库页:全部/官方模板/我的模特 tab + 真人上传 + 模特卡(形象图+三视图缩略+官方标签),仅用 design token
测试:assets 10/10 绿;tsc+build 全绿;无头走查 0 console error(全部5/官方3/我的2,官方标签达标)
基线既有 7 失败(ai/projects provider mock 漂移)零新增
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
223 lines
18 KiB
Markdown
223 lines
18 KiB
Markdown
# UI 还原核对清单 · 2026-06-20
|
||
|
||
> 用户(UI设计师)实测走查反馈,5 个只读代理对照 React 真代码 vs HTML 标准答案核实。
|
||
> **本轮只核对+对齐,未改任何代码。** 对齐后再按批开工。
|
||
|
||
图例:🔴 明显错/影响使用 · 🟡 视觉不达标 · 🟢 小细节 · ❓ 需用户拍板
|
||
|
||
---
|
||
|
||
## A. 商品库(products.tsx / products-page.css)
|
||
|
||
| # | 现象 | 真因 | 怎么改 |
|
||
|---|---|---|---|
|
||
| A1 🔴 | 选中商品后底部批量菜单是**白底**,HTML 是黑底 | `.bulk-bar` 全局裸类,`admin-page.css:232` 又定义一份白底(`--surface-raised`)且 main.tsx 最后加载,盖掉了商品库/项目/资产库三处黑底 | 把 admin-page.css 的 `.bulk-bar` 收窄作用域(`.admin-app .bulk-bar` 或改名),还原三处黑底 |
|
||
| A2 🔴 | 退出选择后,批量菜单**一直不消失** | 批量栏显隐绑的是「编辑模式 `body.edit-mode`」,跟「有没有选中」无关;清空只清 selected 不退编辑态 | 改成「选中数 >0 才显示」(对齐 admin-reviews 的 `selected.size>0` 写法),或退出编辑态时收起 |
|
||
|
||
## B. 新建商品(product-create-drawer.tsx)
|
||
|
||
| # | 现象 | 真因 | 怎么改 |
|
||
|---|---|---|---|
|
||
| B1 🔴 | 上传图片没传上、无任何提示,连点 2-3 次才成 | 选图阶段只做本地预览;真实上传在「创建商品后」逐张串行 await,**无 loading、无 catch**,失败被静默吞掉 | 上传加 loading 态 + 失败 toast + 失败可重试 |
|
||
| B2 🔴 | 明明加了图,点创建却提示「没有图片/未创建成功」 | 创建商品后才异步传图,**没等传完就回调** `onCreated`;某张传失败时商品已建但无图 | 改 `Promise.all` 等全部传完再回调;失败整体提示+不静默 |
|
||
|
||
## C. 商品详情 · AI 素材分类乱(products.tsx:550-555 + 后端 assets)
|
||
|
||
现象:分镜图→标成「平台套图」、场景图→标成「平台套图」、人物三视图→标成「模特上身图」。
|
||
|
||
真因(两层):
|
||
1. **后端分类枚举太粗**:`Asset.Category` 只有 person/scene/product_image/video_clip/final_video/upload/uncategorized,**没有** tri_view(三视图)/storyboard(分镜)/background。于是三视图被塞进 person、分镜/场景都塞进 scene。
|
||
2. **前端标签文案也不对**:`scene→"平台套图"`(用户要「场景图」)、`person→"模特上身图"`(三视图不该叫这个)。
|
||
|
||
怎么改:❓需先和你定**分类口径**——平台到底要哪几类素材标签(建议:商品图/场景图/分镜图/人物三视图/模特图/背景图/视频),然后后端补 category 枚举 + 生成时打对标,前端标签表跟着改。**这条要后端+前端一起动,改前必须对齐。**
|
||
|
||
## D. 归档概念 → 删除 + 垃圾桶(全平台)❓大改
|
||
|
||
现状:底层**本就是软删**(Product.status=archived / Asset.is_deleted / Notification.archived_at),只是 UI 文案/交互叫「归档」。命中点:
|
||
- 商品详情素材三态 `通过/不通过/归档`(products.tsx:524-540)— 注:这其实是借审核状态凑的三态,「归档」语义勉强
|
||
- 消息中心「归档」按钮(messages.tsx:227,389)— 真软删,但**没有恢复入口**
|
||
- 商品「删除」确认文案写「不可撤销」(其实是软删)
|
||
|
||
要你拍板的范围:
|
||
- 是只把文案从「归档」改成「删除」+ 加个「垃圾桶/回收站」可恢复?
|
||
- 还是要做完整回收站页(列已删 + 还原 + 彻底删)?后端要补「垃圾桶列表 + 恢复」端点。
|
||
- 素材那个三态(通过/不通过/归档)里的「归档」要不要也去掉、改两态?
|
||
|
||
## E. 视频项目流水线(pipeline.tsx / pipeline-page.css)
|
||
|
||
| # | 现象 | 真因 | 怎么改 |
|
||
|---|---|---|---|
|
||
| E1 🟡 | 每场卡样式跟 HTML 不一样 | 场景名字号 12/字重 600(应 11.5/500)、时间标签字号偏大 | 调字号字重对齐 HTML |
|
||
| E2 🟡 | 故事板舞台多了**灰底大框**,HTML 是干净白底 | `.sb-canvas` 带 border+圆角,外层 content 灰底透出 | 去 border/圆角,舞台用白底、对齐 HTML padding |
|
||
| E3 🟡 | 每场显示 `#1 #2`,HTML 显示**多少秒~多少秒** | 渲染写死序号 `#{sort+1}`,HTML 用时间区间 | 改显示 start~end 秒(需 frame 带时间字段) |
|
||
| E4 🟡 | 「绑定资产」前是个白圆点,像能点 | 渲染用 `.dotc` 占位圆点 | 改成**已引用资产的缩略图**(数据里已有 adopted url) |
|
||
| E5 🔴 | 视频卡上多了「上传」按钮(AI 生成不该有) | pipeline.tsx:3001 多渲染了上传按钮 | 删掉单卡上传(全局上传入口保留) |
|
||
| E6 🟡 | 视频卡标题和右侧状态顶端对齐、高度不齐 | `.video-card-head` 用 `align-items:flex-start` | 改 `center` 垂直居中 |
|
||
|
||
## F. 基础资产页(library.tsx / library-page.css / actor-library.tsx)
|
||
|
||
| # | 现象 | 真因 | 怎么改 |
|
||
|---|---|---|---|
|
||
| F1 🟡 | 「缺三视图」小标签样式不对 | `.tri-missing-badge` 现为橙底白字 r-sm;应白底琥珀字+琥珀边+胶囊 | 改回白底琥珀描边胶囊 |
|
||
| F2 🟡 | 人物提示词框高度随字数变 | textarea `resize:vertical` + 高度自适应 | 固定到「3 行字」高度、`resize:none` |
|
||
| F3 🟡 | 资产详情**例图容器比例错**(应 9:16 完整展示) | `.adx-lead-img` 现 `aspect-ratio:3/4` + cover(裁切) | 改 9/16 + contain 完整展示 |
|
||
| F4 🟡 | **三视图容器比例错**(应 16:9 完整) | `.adx-tri-cell` 默认 3/4 | 改默认 16/9 |
|
||
| F5 🟢 | 「重跑例会」按钮要放右边 | 现靠左 | 容器右对齐 `margin-left:auto` |
|
||
| F6 🟡 | 角色例会提示词栏能拖动改大小 | `.ad-detail-prompt` `resize:vertical` | 改 `resize:none` 固定 |
|
||
| F7 🟡 | 三视图上方两按钮 hover 反色后 **icon 没变白** | `.ad-icon-btn:hover` 只改字色,没给底色反转,icon 跟随 currentColor 但底也没变橙 | hover 给橙底+白 icon(`background:heat;color:white`) |
|
||
| F8 🟡 | 商品卡 vs 人物卡**块大小不一** | 资产网格 180px/14gap/1:1;人物网格 140px/12gap/3:4 | 同页统一尺寸口径 |
|
||
|
||
## G. 图片生成页(ai-tools.tsx)🟢 基本达标
|
||
|
||
逐区块对照后 >99% 对齐 HTML(image-optimize)。唯一细节:结果图右上操作按钮 28px,HTML 是 26px。
|
||
> 注:用户感觉「完全不一样」,但代码层面高度一致——可能用户看的是**另一个模式**(模特图/平台封面表单态)或某个空态。**建议改前先跟用户确认是哪个画面**,再针对性截图比对。❓
|
||
|
||
## H. 拼接导出 → 雪藏到 V2(stage-config.ts / pipeline.tsx)❓
|
||
|
||
要做:阶段菜单去掉「拼接导出」选项 + 整页不渲染(**不删代码**,留 V2)。最小改动:菜单数组去掉 export 项 + Stage5 渲染条件关掉 + Stage4→5 的进入按钮隐藏。组件文件全保留。
|
||
|
||
---
|
||
|
||
---
|
||
|
||
## 📊 平台产出物盘点(测试库实测 · 2026-06-20,共 505 个 Asset)
|
||
|
||
| 实际产出物 | 落在 category(数量) | 现显示标签 | 由哪条流程产 | 名称样本 |
|
||
|---|---|---|---|---|
|
||
| 商品基础图 + 图片创作 + **平台套图** | product_image(154) | 商品图 | 商品基础资产 / 图片创作(image) / **平台套图(cover→此桶)** | 杂鱼煲-主图、AI生成·平台套图·4、AI生成·图片创作·1 |
|
||
| 人物基础图 + 模特上身图 + **三视图** | person(131) | 模特上身图 | 人物基础资产 / 模特上身(model) / **三视图(services.py:854 塞此)** | AI生成·模特上身图·1、v1-三视图 |
|
||
| 场景图 + **故事板分镜** | scene(130) | 平台套图 | 场景基础资产 / **故事板每镜(services.py:1147 塞此)** | v1-storyboard-4 |
|
||
| 视频片段 | video_clip(49) | — | 视频阶段每段 | v1-segment-4 |
|
||
| 最终成片 | final_video(24) | — | 拼接导出(export.py:508) | v1-final.mp4 |
|
||
| 配音 + BGM(音频) | uncategorized(14)+upload(3) | — | 配音 / BGM | 配音·场4·句2、BGM·轻电子节奏 |
|
||
|
||
**乱点总结:**
|
||
- `person` 桶混了 人物基础图 / 模特上身图 / **三视图** 三种 → 三视图被叫"模特上身图"。
|
||
- `scene` 桶混了 场景图 / **故事板分镜** → 都被叫"平台套图"。
|
||
- **名实错位**:平台套图(cover)落进 `product_image` 桶(services.py:1499)显示"商品图";而 `scene` 的标签却叫"平台套图"。
|
||
- 音频(配音/BGM)散落 uncategorized + upload,没有独立类。
|
||
- 现 7 个枚举太粗、且一桶多用 → 标签必然错。要么细化 category,要么靠 name/metadata 二次区分。
|
||
|
||
## 归档逻辑现状(三处"归档"各不相同)
|
||
1. **消息中心「归档」= 真软删**:点了 `archived_at` 打时间戳,列表查询直接过滤掉(ops/views.py:256),消息从 UI **消失且无任何恢复/回收站入口**,只有后台 Django admin 能看到。实测库 0 条已归档(功能在、没人用过)。
|
||
2. **商品「归档」(status=archived)= 定义了但前端没用**:商品实际走「删除」(确认文案写"不可撤销"=按硬删理解);实测 35 个全 active、0 archived。
|
||
3. **商品详情素材卡「归档」= 假归档**:只是审核状态映射的中性标签(active→通过/failed→不通过/其它→归档),不动任何数据。
|
||
|
||
## 图片生成页(asset-factory)真实差异(订正:不是像素间距)
|
||
对照截图,真问题在**任务中心的任务卡内容**,不是排版间距(排版 99% 对):
|
||
- 任务卡标题渲染 `TASK_TYPE_LABEL[task_type] || task_type`(ai-tools.tsx:313),但库里 `task_type` 实际是 `product_image/person_image` 等,**不在标签表(只有 model/platform/image…)** → 直接显示生英文 "product_image // product_image"。
|
||
- HTML 标准:任务卡标题是「商品名 × 模特/平台」+ 副标「类型 · N张」(如"南卡 Lite Pro 蓝牙耳机 × 天猫 / 平台套图·4张")。
|
||
- 默认 `view="grid"` 网格(ai-tools.tsx:152)+ 失败任务无图 → 一片占位斜纹块;HTML 默认列表、干净。
|
||
|
||
---
|
||
|
||
---
|
||
|
||
# ✅ 落地进度(2026-06-20,全程本地 commit、未 push)
|
||
|
||
| 波次 | 内容 | commit | 验证 |
|
||
|---|---|---|---|
|
||
| W1 | 批量栏白底→黑底(+退选即收起) | b946a64 | tsc/build 绿 |
|
||
| W1 | 图片生成页排版还原(标题上移/三卡左对齐矮/按钮贴描述) | b946a64 | 截图实测 |
|
||
| W1 | 视频卡删多余上传按钮+标题状态居中 | b946a64 | tsc 绿 |
|
||
| W1 | 拼接导出雪藏(菜单去掉+入口隐藏,代码留) | d7f7ed2 | e2e 4步 |
|
||
| W1 | 故事板:#序号→时间区间/绑定资产圆点→缩略图/灰底→白底/字号 | 8550d53 | 截图+e2e |
|
||
| W1 | 基础资产 F1-F7(缺三视图标签/提示词框固定/9:16+16:9/重跑右/hover反白) | 2e88071 | 截图详情弹窗 |
|
||
| W2 | 新建商品上传健壮性(loading/失败提示/等齐再关/不重复建) | b8fc1a0 | tsc 绿 |
|
||
| W3 | 垃圾桶(商品软删+回收站+左侧入口,前后端) | 3469799 | 后端5测试+e2e全流程 |
|
||
| W3 | 素材卡归档按钮→只读审核状态 | 998b0bf | tsc/build 绿 |
|
||
|
||
**挂起/待拍板:**
|
||
- **F8**(商品块 vs 人物块统一):基础资产页商品是「详情块」、人物是「卡片」,结构本就不同 → 需你指认到底哪两块要等大。
|
||
- **★W4 后端分类改造:撞合规红线,停下待拍板**(见文末)。
|
||
|
||
---
|
||
|
||
# ★★ 资产模型重定义(2026-06-20 用户盘点,W4 以此为准 —— 已不止是"改分类")
|
||
|
||
这不是简单给 category 改名,是把「模特」从一张图升级成**可复用的实体/库**。三大块:
|
||
|
||
**① 模特(顶级独立类 = 模特库)**
|
||
- 一个完整模特 = **形象图 + 三视图 + 声线**(三件套合成一个模特)
|
||
- 模特库**独立成块**(像商品库),**图片线 + 视频线都能调**(=演员库);商家**真人模特可上传**入库
|
||
- 现状问题:模特库现在埋在 model-photo.html 的深层嵌套弹窗里(actor-library),UI 当初没想清楚 → 要提到顶级
|
||
|
||
**② 图片趴(3 类,均为「组」)**
|
||
- **模特上身图**(组):模特+商品宣传图,一组多张
|
||
- **平台套图**(组):电商头图/轮播主图,各平台尺寸不同,一组 N 张(平台规则后续加)
|
||
- **自由创作**:杂图都归这
|
||
|
||
**③ 视频趴**
|
||
- **模特图**:关联模特库 → 引用库中某模特的脸 → 生成符合本脚本剧情的演员**定妆照** → 再出三视图;也可直接 AI 生成角色
|
||
- **分镜图**(组):每个视频任务脚本 = 一组分镜图 + 一组视频素材
|
||
|
||
**结构含义(待规划):** 模特要从「项目内的 person 基础资产」升级为「团队级、跨流程复用的模特实体」;上身图/套图/分镜/视频都是「组」;视频流程的模特图引用模特库。→ 这是**多阶段功能**,不是一次 relabel。审核范围不变(视频趴人脸:模特定妆照/三视图/分镜送审)。
|
||
|
||
---
|
||
|
||
# ⛔ Wave 4(原"后端分类改造")— 已升级为「资产模型重定义」,需先出设计稿
|
||
|
||
摸完代码发现:**火山人像内容审核(P0 法务红线)绑死在 `category=person`**(assets/review.py:64、adminpanel 审核队列)。现在三视图算 person → **会送审**。若按新分类把三视图/模特上身图从 person 拆走,它们就**不再过内容审核**。这是合规决策,不能我自己定。
|
||
|
||
**✅ 用户已拍板(2026-06-20):**
|
||
平台两大趴 = ① 图片资产生成 ② 带货视频生成。通用模特可拍上身图、可出演视频。
|
||
- **只有「视频趴」带人脸素材送审**:模特形象图(立绘) / 三视图 / 分镜图 → 调 Seedance 出视频前必须过火山审核(不然被 ban)。
|
||
- **图片趴不送审**:模特上身图 / 平台套图 / 自由创作图 —— 图直接给电商用,不进视频、不调 Seedance。即便商家拿上身图当参考生成视频,那是第二阶段的事(等第一版反馈再说)。
|
||
- 所以审核集合 = **{PERSON(模特形象图), TRI_VIEW(三视图), STORYBOARD(分镜图)}**;MODEL_TRYON/PLATFORM_KIT/FREE_CREATE 不审。
|
||
- 待确认:历史 505 条数据重打标用一支可逆数据迁移(你确认低峰再在测试库跑)。
|
||
|
||
拍完这俩,W4 我一次做完:Asset.Category 细化 + 各生成流程打标 + 前端标签表 + 演员库三毛病 + 资产库「成片」→「素材」+ 最终成片隐藏 + 数据迁移 + 后端测试。
|
||
|
||
---
|
||
|
||
# ★ 对齐结论(2026-06-20 用户拍板,以下为准)
|
||
|
||
## 素材分类方案(取代 C/D 旧讨论)
|
||
**电商物料类(图片生成产出):**
|
||
1. 模特上身图 — 独立类
|
||
2. 平台套图 — 独立类
|
||
3. 自由创作图 — 独立类(含详情图/海报等,合并到一起)
|
||
|
||
**视频项目类:**
|
||
4. **模特** — 实体类(命名最终定为「模特」,不叫人物/演员)。我自己生成的 + 官方给的**都叫模特**,只用「官方」徽章区分来源。
|
||
- 一个模特实体 = 立绘 + 三视图 +(将来)声音,**都挂在该模特身上**。
|
||
- 模特两个用途:① 生成模特上身图(配具体商品)② 演剧(视频项目当角色)。
|
||
5. 分镜图 — 独立类
|
||
6. 视频片段 — 独立类
|
||
7. ~~最终成片~~ — 拼接 1.0 已隐藏,此类**先隐藏**,以后再加
|
||
|
||
**基础资产 / 参考元素:**
|
||
8. 模特声音 — 每个模特一个声音,**挂在模特实体下**(不再纠结独立 or 打包,就跟着模特走)。**回头做**(还要在"参考元素"里加"声音"选项,方便统一生成);本轮先知道有这个类,不动。
|
||
|
||
> 注:「模特」(实体/人)与「模特上身图」(产出物=模特+具体商品、带商品信息、可能成套)是两码事,不冲突。模特上身图名字以后可能再改。
|
||
|
||
## 演员库("模特库")现状三个毛病(待改)
|
||
弹窗入口:视频项目流程第4步 人物卡替换/新增、图片生成→模特上身图→选择模特。判定"谁是模特"= 凡 category=person 有图的资产。问题:
|
||
1. 🔴 **三视图混进模特卡**:三视图也打 person 类(services.py:854),被当成独立"模特"卡和立绘平级。应:三视图单独成类、从属于模特。
|
||
2. 🔴 **官方/自定义分错**:`isPreset` 把"凡 ai_generated"都算官方预设(actor-library.tsx:13),用户自建也是 ai_generated → 全进"平台预设","我的演员"几乎永空。应:按真实来源标记(官方 badge)区分。
|
||
3. 🟡 **立绘↔三视图父子关系弱**:仅靠 metadata.triview_of 弱挂,演员库没用它,平铺所有 person。应:建明确父子,模特库只列模特本体(立绘)。
|
||
|
||
**砍掉:** 配音 — 暂不做(原 uncategorized 里的配音/BGM 先不管)。
|
||
|
||
**资产库改名:** "成片" tab → 改为 **"素材"**。
|
||
|
||
> 落地影响:后端 `Asset.Category` 枚举要按上面细化,各生成流程(三视图 854 / 故事板 1147 / cover 1499 等)打对标,前端 `PD_ASSET_TYPE_LABEL` 跟着改。最终成片类前端先隐藏。
|
||
|
||
## 归档 → 删除 + 垃圾桶
|
||
- **商品删除 → 进垃圾桶**;**左侧主菜单新增「垃圾桶」入口**(可恢复)。
|
||
- 商品详情素材卡的「归档」**不是用户可点的按钮** → 改为**审核状态展示**:团队管理员审核 → 通过 / 不通过;用户侧只读看状态(对接已有 review_status 绿/红盾语义)。
|
||
- **消息中心:本轮先别动**(用户觉得现状有较大问题,回头单独改)。
|
||
|
||
## 图片生成页(asset-factory)— 排版还原(取代 G 旧结论)
|
||
确认是 asset-factory 落地页,任务中心布局 OK(之前看到的差异是切了视图没切回),要改:
|
||
- A. 标题「图片生成」+ 下方小字**整体位置偏低** → 上移对齐 HTML。
|
||
- B. 三张卡(模特上身图/平台套图/图片创作)**未左对齐 + 间距不对 + 卡片高度偏高** → 对齐 HTML(统一左对齐、统一高度、收间距)。
|
||
- C. 「开始生成」按钮与上方描述行**间距过宽** → 收紧。
|
||
- D. 任务卡标题/副标内容应为「**商品名 × 模特/平台**」+「类型 · N 张」,现在显示生英文 `product_image` → 改(内容层,跟分类一起理)。
|
||
|
||
## 本轮可立即开工(不依赖进一步拍板)
|
||
A1 白底菜单、A2 菜单不消失、B1/B2 上传、E1-E6 流水线、F1-F8 基础资产、H 拼接导出雪藏、图片生成页 A/B/C 排版、左侧加垃圾桶 + 商品删除进垃圾桶、素材卡归档改审核状态。
|
||
|
||
## 待后续单独排期(本轮不碰)
|
||
人物声音类 + 参考元素加声音、模特库完整功能(官方模特库)、消息中心重做、最终成片类恢复(随拼接 2.0)。
|